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M68KSYSGEN/D7 -- March 1985. Reflects the following software levels: 
VERSAdos 4.4 and Link 1.8. Adds support of the MC68G20, VM04, MVME120, 
MVME121, MVME122, and MVME123. New features: SYSGEN is now done under 
catalog name of system to be made using one generic SYSGEN command file, 
&. VERSADOS. CD. SYSGEN listing only lists drivers that were included. It is 
easier to configure system for drivers and to add independent drivers. All 
information is derived from system and driver configuration INCLUDE files. 
The SGSYMBL.LO is an optional pass two processor that generates a readable 
cross reference listing file (SYMBOLS. LS) of the parameters used during a 
SYSGEN. 

M68KSYSGEN/D8 -- November 1985. Adds support of the MVME117, MVME130, and 
MVME13I VMEmodules. Makes minor corrections to the manual , incorporates 
boldface type in input/output examples, and adds a keyword index. 
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CHAPTER 1 
GENERAL INFORMATION 




1.1 INTRODUCTION TO SYSGEN 

The VERSAdos System Generation Facility (SYSGEN) allows the user to custom- 
generate an operating system to suit a particular application. An operating 
system can be built around the RMS68K kernel, or the standard VERSAdos system 
furnished for a computer system can be customized. To generate a new 
operating system, a SYSGEN command file is edited by the user, using SYSGEN 
commands that establish parameters for the desired system configuration. A 
usable operating system boot file is created by performing the SYSGEN boot 
file process on the command file. To do a SYSGEN, the minimum memory 
requirement is 384Kb; however, 512Kb is required for EXORmacs and may be 
required for VMEmodule-based and VM04-based systems because of the additional 
disk controllers, drivers, and/or page sizes for Memory Management Unit (MMU) 
operation. 

To enable SYSGEN to run in 384Kb of memory, Device Control Blocks/Channel Data 
Blocks are assembled individually and linker/merged dynamically as required. 
The "VERSAPT" patch files are also built dynamically as modules are used. 

Each product or system type (refer to Table 1-1) has four SYSGEN support files 
furnished: 

a. A copy file named <system>.COPYSGEN.CF 

b. A switch file of boards for the system named <system>.CNFGDRVR.CI 

c. A conditional INCLUDE file (based on the switch file) named 
<system>.IFDRVR.CI 

d. A system dependent file named <system>. SYSTEM. CI 



There are several generic files also furnished 
a. &. VERSADOS. CD 



b. STD. SYSGEN. CF 

c. NOLIST. SYSGEN. CF 

d. &. SYSGEN. CF 



Contains the SYSGEN commands and parameters and 
INCLUDE statements. Note that the ampersand (&) 
represents a null catalog. 

Invokes the &. SYSGEN. CF file with the default 
arguments and creates all listing files. 

Invokes the &. SYSGEN. CF file with the default 
arguments but does not create the SYSASML.LS 
listing file. 

Executes the SYSGEN process with specified 
arguments (user defined or default). 
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TABLE I-l. Command and Chain Filenames 



PRODUCT 


USER 


CATALOG 


SYSTEM 


CONFIGURATION 




TYPES 


NUMBER 


<system> 


INFORMATION 


INFORMATION 


CONDITIONAL 


EXORmacs 


9998 


EXORMACS 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


VME/IO 


9998 


VMESIO 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


VMOl 


9998 


VMOl 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


VM02 


9998 


VM02 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


VM03 


9998 


VM03 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


VM04 


9998 


VM04 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


VMC 68/2 


9998 


VM02 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


MVMElOl 


9998 


VMElOl 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


MVMEIIO 


9998 


VMEIIO 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


MVMEI17 


9998 


VME117 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


MVME120/121 


9998 


VME120 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


MVME122/I23 


9998 


VMEI22 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


MVME130 


9998 


VMEI30 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


MVME131 


9998 


VME131 


SYSTEM. CI 


CNFGDRVR.CI 


IFDRVR.CI 


NOTE: All 


systems 


use command file 


& 


.VERSADOS.CD. 




All 


systems 


use copy file 


<system> 


.COPYSGEN.CF. 




All 


systems generate bootabl 


e file <system> 


.VERSADOS.SY. 





If all parameters in the furnished VERSAdos (as listed in the appropriate 
<system>. CNFGDRVR.CI, <system>. SYSTEM. CI, and &. VERSADOS. CD files), agree with 
the user system configuration, the bootable <system>. VERSADOS.SY file may be 
used as is -- with no modification or SYSGEN. The appropriate configuration 
file (<system>.CNFGDRVR.CI) can be listed and examined to determine which 
boards/drivers are online in the corresponding standard bootable VERSADOS.SY 
file, and whether changes are necessary. The command, chain, and INCLUDE 
files for each target system are identified by their catalog name <system>. 
(Refer to Table I -I.) 

To perform a SYSGEN, run the <system>. COPYSGEN.CF chainfile to copy all the 
required files (including equate, macro, and UTILIB.RO), for that system into 
a user defined account. After the completion of COPYSGEN.CF, run the 
STD. SYSGEN. CF to invoke the SYSGEN process. SYSGEN must run under a catalog 
equal to the system type; e.g., to run an MVME120 SYSGEN in user account 9100 
on hard disk volume SYS, enter the command: 

USE SYS:9100.VMEI20 

The file STD. SYSGEN. CF produces three listing files: 

a. <system>.SYSLIST.LS Lists the output of the SYSGEN process. 

b. <system>.SYSASML.LS Contains the listings from the assemblies and 

links that were done during the SYSGEN process. 

Contains a listing and cross-reference of all 
symbols and parameters with their values. 



c. <system>. SYMBOLS. LS 



MICROSYSTEMS 



@) MOTOROLA 



GENERAL INFORMATION 



If the user does not want the SYSASML.LS file produced, run the file 
NOLIST.SYSGEN.CF. Using NOLIST.SYSGEN.CF reduces the time used by SYSGEN. 

Chapter 2 presents the SYSGEN command syntax, both for the furnished chain and 
command files and for invoking SYSGEN directly on a user-written command file. 
Chapter 3 describes the SYSGEN command set. Chapter 4 describes the SYSGEN 
ROM capability. 

Appendix A discusses control blocks and tasks. Appendix B describes hardware 
and software configuration. Appendix C contains listings of typical Motorola- 
furnished command files (for a VME/10 system both before and after SYSGEN is 
performed) and shows a typical SYSGEN-generated system map. Appendix D 
contains definitions of the SYSGEN parameters. Application INCLUDE file 
examples for both an assembly task and a Pascal task are shown in Appendix E. 
Appendix F contains an extract from a system SYSGEN listing. 

1.2 DESCRIPTION 

Some system attributes that can be tailored using the SYSGEN commands include: 

a. Type and number of devices. 

b. Number of users. 

c. Number of logical units per user. 

d. Amount of memory space for Global Segment Table (GST), Trace Table 
(TT), and Device Connection Queue (DCQ). 

e. Number of files. 

Since a file of commands is required as input, SYSGEN operation is similar to 
chain mode. However, all commands in the input file must be from the SYSGEN 
command set. The commands can reference source files, relocatable modules, 
and loadable modules that can contain tasks or code for execution in the 
supervisor mode. Adjusting the SYSGEN process to tailor the resulting file 
for a particular system configuration is done by modifying SYSGEN commands in 
the input command file. Source files may also require modification. Figure 
1-1 shows a typical example for some SYSGEN commands including the main inputs 
and outputs. 

SYSGEN handles module streams. A module is either a process or a task. A 
process includes code that runs in supervisor mode. A task includes code that 
runs in user mode and has Task Control Blocks (TCBs) and Task Segment Tables 
(TSTs), built by SYSGEN, associated with it. During the SYSGEN procedure, all 
process and task load module files are merged into a single output file 
suitable for boot loading. 

SYSGEN is a text processor/substituter that controls the assembly and link of 
modules required for VERSAdos. Figure 1-2 shows the system flow of how SYSGEN 
controls these modules. 
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1.3 NOTATION 

The following conventions are used in the command syntax, examples, and text 
in this manual: 

< > Angle brackets enclose a "syntactic variable" that is to be 
replaced in a command line by one of a class of items it 
represents. 

boldface A boldface string is a literal, such as a command or a program 
strings name, and is to be typed just as it appears. 

I This symbol indicates that a choice is to be made. One of 
several items, separated by this symbol, should be selected. 

[ ] Square brackets enclose an item that is optional. The enclosed 
item may occur zero or one time. 

[ ]... Square brackets followed by periods enclose an item that is 
optional /repetitive. The item may appear zero or more times. 

Operator inputs are followed by a carriage return. The carriage return is 
shown as (CR) if it is the only input required. 

1.4 RELATED DOCUMENTATION 

The following publications may provide additional helpful information. If not 
shipped with this product, they may be obtained from Motorola's Literature 
Distribution Center, 616 West 24th Street, Tempe, Az 85282; telephone (602) 
994-6561. 



MOTOROLA 
DOCUMENT TITLE PUBLICATION NUMBER 



M68000 Family CRT Text Editor User's Manual M68KEDIT 

M68000 Family Real-Time Multitasking Software M68KRMS68K 

User's Manual 

VERSAdos to VME Hardware and Software Configuration MVMEVDOS 

User's Manual 

VERSAdos Data Management Services and Program Loader RMS68KI0 
User's Manual 

M68000 Family VERSAdos System Facilities Reference Manual M68KVSF 

M68000 Family Resident Structured Assembler M68KMASM 

Reference Manual 
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FIGURE 1-1. SYSGEN Command Pictorial 
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CHAPTER 2 
INVOKING SYSGEN 

2.1 GENERATING AN OPERATING SYSTEM USING SYSGEN 

After the configuration and/or system files have been written or modified for 
the user configuration using the VERSAdos Editor, the SYSGEN facility must be 
called to create the new bootable VERSAdos load module. SYSGEN may be called 
directly or by executing either of the furnished chainfiles, STD. SYSGEN. CF, 
NOLIST. SYSGEN. CF, or &. SYSGEN. CF, to execute on the furnished command file, 
&. VERSADOS. CD. The configuration file contains descriptions of the user- 
changeable parameters and is the place where most changes are made. The 
system file also contains some user-changeable parameters. Specific driver 
items are found in the specific driver-related files. 

Paragraph 2.2 contains instructions and the command line syntax for invoking 
SYSGEN on the furnished chainfiles, which then automatically operate on the 
furnished command files. To invoke SYSGEN directly on a command file, use the 
command line syntax in paragraph 2.3. 

2.2 USING THE FURNISHED SYSGEN FILES 

The procedures below apply to the VERSAdos releases for multi-user hard disk 
and single-user hard disk. 

2.2.1 SYSGEN Steps 

SYSGEN is performed on a hard disk. The steps required are: 

a. Log on to the system default volume as user number 9100. This user 
number is the one normally reserved for SYSGEN processing; however, 
the user may elect to log on with a different user number. User 
numbers 9500-9999 are reserved for system use and should not be used 
as SYSGEN account numbers. Do not use user number because the 
VERSADOS. SY file created will overwrite the existing VERSADOS. SY file 
under user number 0, and the system may not be rebootable. 

b. To set up the volume, user number, and catalog (system type), issue a 
USE command where the SYSGEN will be done (for example, USE 
SYS: 9100. EXORMACS). 

c. To copy all the necessary files into 9100, including equate, macro, 
and UTILIB.RO files, invoke the appropriate copy chainfile (e.g., 
: 9998. EXORMACS. COPYSGEN.CF). The chainfile contains documentation of 
the syntax for running the chainfile. The <system>. COPYSGEN.CF 
chainfile automatically sets the catalog to the correct system. 

NOTE: The MVME600-series drivers will not be copied (default). Refer 
to the chainfile documentation for details. 
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d. Modify the <systein>.CNFGDRVR.CI file to select the board configuration 
for your system. Normally, this is all that needs to be done for most 
systems. You may optionally need to modify the <system>. SYSTEM. CI 
file, the &.VERSADOS.CD file, or specific driver files for non- 
standard media units. These files will have names such as 
&.M320DRV.CI and IOC.M320DRV.AG. 

e. Start the SYSGEN process by invoking STD. SYSGEN. CF or NOLIST. SYSGEN. CF 
while under the catalog of the system being SYSGENed, or use 
&. SYSGEN. CF directly. Refer to these chainfiles for details on their 
usage. STD. SYSGEN. CF creates three listing files (.LS) and a bootable 
VERSAdos file (<system>.VERSADOS.SY) in the default account number/ 
catalog. The first listing file is called <system>.SYSLIST.LS and 
contains all SYSGEN commands. The second listing file is called 
<system>.SYSASML.LS and contains all SYSGEN assembly and link 
listings. The third listing file is called <system>. SYMBOLS. LS and 
contains a cross-reference listing of the system symbols used. 
NOLIST. SYSGEN. CF creates two listing files (<system>.SYSLIST.LS and 
<system>. SYMBOLS. LS) and a bootable VERSAdos file (<system>. 
VERSADOS. SY) in the account number/catalog (<system>.SYSASML.LS is not 
produced). 

f. Log off the system. 

g. Log on as user and save the current version of VERSADOS. SY by 
renaming it PRIOR. VERSADOS. SY. Then copy the new VERSADOS. SY from 
your SYSGEN account number to user 0. 

h. Boot the new VERSAdos operating system by the usual method. 



2.2.2 Driver Configuration File 

The SYSGEN driver configuration file is <system>.CNFGDRVR.CI, where <system> 
is the name of the target system. This file consists of flags for each 
possible board type allowed in the system and any parameters required for the 
boards. This file is normally the only one that needs to be modified for most 
SYSGENs performed to add or remove standard device drivers. All other 
parameters are derived from these board switch parameters. 



The as-delivered setting 
that particular system. 



is for the standard VERSAdos operating system for 



2.2.3 System Dependent File 

The system dependent file is <system>. SYSTEM. CI, where <system> is the name of 
the target system. This file contains parameters for the system's CPU board 
and the overall system itself. The user should not have to modify this file 
for normal SYSGENs. 
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2.2.4 Conditional Driver INCLUDE File 



The SYSGEN conditional INCLUDE driver file is <systein>.IFDRVR.CI, where 
<systein> is the name of the target system. This file contains conditionals 
based on the board switches in <system>.CNFGDRVR.CI to include only those 
drivers necessary to support the boards that have been configured into the 
system. The user should never have to modify the conditional INCLUDE driver 
file unless device drivers are being written for custom boards not supported 
by standard VERSAdos. (Refer to the Guide to Writing Device Drivers for 
VERSAdos, M68KDRVGD.) 




2.2.5 SYSGEN Execution 

When all SYSGEN files have been modified to reflect the desired configuration, 
SYSGEN may be executed. This is usually done by using one of the furnished 
chainfiles. After logging on to the appropriate volume as user 9100 with 
catalog equal to the system type of this SYSGEN, the user should type in the 
following command line: 

=STD. SYSGEN. CF 

This starts a standard SYSGEN with two listing files (.LS), one boot file 
(.SY), and one cross-reference file (.SY) to be generated. This chainfile 
does a NOARG and calls &. SYSGEN. CF to set the default conditions. You may 
optionally use &. SYSGEN. CF directly by entering the command line: 



=&. SYSGEN. CF <argl>,<arg2>,<arg3>,<arg4>,<arg5> 



where: 

<catalog> 



<argl> 
<arg2> 



<arg3> 
<arg4> 



is set to the system type and <arg-n> are arguments. 

NOTE: Entry of all arguments is not necessary because each 
has a default value. Separating commas are required, 
however, whether defaults are used or not. 

Command filename. Default: &. VERSADOS. CD 

<temporary volume>:<user number>/<boot file>. Default: Logon 
volume name and user number. Refer to paragraph 2.3 for 
description of <temporary volume> and <boot file>. 



List device or filename for SYSGEN messages. 
<system>.SYSLIST.LS. 

Reserved for future use. 



Default: 
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<arg5> Listing device or file. Default: <systeni>.SYSASML.LS. Legal 
devices are #, #PR, #PR1, #PR2, #PR3, #NULL, or a filename. 
All assembly listings and link maps are directed to the 
specified device or file. If <arg5> is a file, SYSGEN. TF is 
used as a temporary listing file to hold assembly and link 
listings before being copied to the desired output file, using 
the COPY utility with the append {;A) option. If <arg5> is 
#NULL, no assembly and link listings file is created. Due to 
restrictions in the SYSGEN literal substitution process, 
<arg5> cannot contain more than 30 characters. 

The resulting boot file, <system>.VERSADOS.SY, is built under the user default 
volume and catalog. 

The user can run the NOLIST. SYSGEN. CF file to do a SYSGEN with only the map 
and cross-reference listings. This reduces the time used by SYSGEN. 

&.SGSYMBL.LO is an optional part (pass 2) of &. SYSGEN. LO that is run to create 
a readable output listing file from the resulting cross reference file, 
SGSYMS.SY, built under the user default volume and catalog. 

NOTE 

If the SYSGEN is ended prematurely, clear the arguments 
with "-NOARG" before reinvoking the SYSGEN chainfile. 

EXAMPLE 



»NOARG 

=USE 9100.EX0RNACS 

=&.SYSGEN.CF .,SYSLIST.LS,,SYSASML.LS 

This command executes the furnished chainfile &. SYSGEN. CF. The defaults used 
are: 



<argl>= & . VERSADOS . CD 

<arg2>= logon volume and user number. 

<arg4>= null 
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2.3 INVOKING SYSGEN DIRECTLY 

The following command line invokes SYSGEN directly. Note that the supplied 
SYSGEN command files require additional arguments to be defined in the ARG 
command. These additional arguments are defined automatically when using the 
appropriate SYSGEN. CF chainfile. Thus, it is recommended to invoke SYSGEN 
through the chainfile instead of directly. 

=SYSGEN <command file>[,<temp vol>|,<temp vol>/<boot file>| ,/<boot file>|,] 
[,<list device>][5<options>] 




where: 



SYSGEN 



<command file> 



<temp vol> 



<boot file> 



<list device> 



is the command mnemonic. 

is the name of the file containing the SYSGEN commands. 
The extension defaults to CD. Volume ID, user number, and 
catalog default to user defaults. Command filenames may be 
concatenated with a slash (/) between them (e.g., 
SYSCMD1/SYSCMD2/SYSCMD3). SYSGEN processes the three files 
as if they were one continuous file. 

is the volume name and user number for the temporary output 
file(s) created by the utility. Defaults to the logon 
volume name and user number if not specified. 

is the name of the boot file created by the utility. If 
not specified, the volume ID, user number, and catalog 
default to the user defaults, and the filename and 
extension default to VERSADOS.SY. An existing file is 
overwritten. 

is the name of the device or file where all messages are 
sent. (Default is the logon device.) If a filename is 
specified, the extension default is LS; volume ID, user 
number, and catalog defaults are the user defaults. An 
existing file is overwritten. 

The output listing from the SYSGEN process contains all the 
SYSGEN command lines as they appeared in the SYSGEN command 
file. All processed statements are preceded with the two- 
character string ". ". If the statement was read and not 
processed, two blanks precede it. Error messages are 
preceded by "%%" and auxiliary information is preceded by 



<options> is one or more of the following: 

R Causes the operating system to be configured for a 
Read Only Memory (ROM) environment. 
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When the R option is selected, the TCB is appended to 
the end of the boot file in an abbreviated format to 
conserve ROM space. After booting the operating system, 
this abbreviated TCB is expanded and written to RAM by 
the system initializer. The format for this compressed 
or "mini" TCB is: 



MTCB 


DC.L 


MTCB' 


MTCBNAME 


DC.L 


<taskname> 


MTCBSESSN 


DC.L 


<task session> 


MTCBMON 


DC.L 


<monitor taskname> 




DC.L 


<monitor task session> 


MTCBUSER 


DC.W 


<user number> 


MTCBLPRI 


DC.B 


<priority> 




DC.B 


<reserved> 


MTCBSTATE 


DC.W 


<state> 


MTCBATTR 


DC.W 


<attributes> 


MTCBENTRY 


DC.L 


<entry address> 


MTSTMMU 


DS.B 


32 Task Segment Table MMU information 


MTSATTR 


DS.B 


32 Task Segment Table attributes 



The total length of this compressed TCB is 96 bytes. 

The TCBs are built contiguously on disk, with the end of 
the list determined by a binary zero taskname. 

P Causes the operating system to be configured with 
physical addresses only, i.e., configured to run on 
a system having no MMUs. For each memory management 
segment in the boot file, a physical starting 
address is assigned which matches the logical 
starting address obtained from the Loader 
Information Block (LIB) of the segment. 

S Allows execution of a SYSGEN command file to be 
restarted at the beginning -- skipping execution of 
ASM, COPY, DEL, LINK, SUBS, and PAUSE commands -- 
until a prescribed point is reached, after which 
full processing is resumed. The purpose of the 
option is to save time and is normally used when a 
SYSGEN command file is changed or when SYSGEN 
execution has stopped prematurely. 

The point where full execution is to resume is 
specified as a character string taken from the 
appropriate SYSGEN command file line. If there is a 
premature stop, look at the SYSGEN listing and 
specify the next to the last SYSGEN command executed 
as the restart point. The SYSGEN program searches 
for the string, resuming full execution when a match 
is found. 
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CAUTION 

THE RESTART OPTION MUST NOT BE USED AT OR 
AFTER THE ASSEMBLY OF IOC. BEGIN. AG AND 
BEFORE THE PARAMETER MEMBEG =* IN THE 
i.VERSADOS.CD FILE. THE lOC.RO MODULE IS 
BUILT DYNAMICALLY AND THE ENTIRE PROCESS 
MUST BE EXECUTED CONTIGUOUSLY OR THE lOC.RO 
MODULE WILL NOT BE BUILT CORRECTLY. THIS 
MEANS YOU CANNOT RESTART AT ANY OF THE 
DRIVER FILES, OR WITHIN CNFGDRVR.CI, 
IFDRVR.CI, SYSTEM. CI, OR i.VALPAR.CI. 



No restrictions are placed on length or content of 
the string, which is specified during the following 
dialog after execution of the SYSGEN command line is 
initiated: 

ENTER CHARACTER MATCHING PATTERN FOR RESTART 

After the entry of the desired string and a carriage 
return, the program responds with: 

RESTART OPTION SPECIFIED - MATCH PATTERN IS: xxxxxx 

where xxxxxx is the entered string. The entry of a 
carriage return initiates the abbreviated processing 
of the SYSGEN command file until it matches the 
specified string. Then the program displays: 

NORMAL PROCESS RESUMING FROM RESTART 



B 



Resumes full SYSGEN processing and continues to the 
end of the command file. 

T-n Allows the user to specify the number of user- 
defined symbols in the symbol table, thus either 
increasing or decreasing the amount of memory to be 
allocated for the symbol table. For example: 

=SYSGEN SYSCMD,,SYSLIST.LS;T=350 

causes execution of SYSGEN, using SYSCMD as the 
command file, and SYSGEN sets aside enough memory to 
accommodate 350 symbols in the symbol table. 
(Default=170.) 

If SYSGEN is unable to allocate enough memory, it 
displays the message: 

"WAITING FOR PHYSICAL MEMORY TO BECOME AVAILABLE!!" 
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When SYSGEN has allocated enough memory for the 
symbol table, the message: 

"PHYSICAL MEMORY HAS NOW BEEN ALLOCATED!!" 

displays and SYSGEN automatically continues 
operation. 

Causes SYSGEN to create a cross-reference file, 
SGSYMS.SY (default), under the user's current 
defaults, which contains information about the 
SYSGEN defined parameters and the user-defined 
parameters. The information in this file is the 
parameter name, the value for the parameter, the 
file(s) that define the parameter, and the file(s) 
that reference the parameter. The SGSYNBL utility 
is run to create a readable output listing file, 
SYMBOLS. LS, from the SGSYMS.SY file (refer to 
paragraph 3.20). 
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CHAPTER 3 
SYSGEN UTILITY COMMANDS 



3.1 THE SYSGEN UTILITY COMMAND LIST 

This paragraph presents a brief description of each SYSGEN utility command. 
Detailed descriptions of each command follow this paragraph. A SYSGEN command 
line with an "*" as the first non-blank character is treated as a comment; the 
line is listed but no processing takes place. Any utility program not 
requiring interactive dialog may be invoked from within the SYSGEN command 
file by placing an "=" as the first non-blank character, followed by the 
command line. 



B 



<parameter> is the name of a SYSGEN parameter followed by its value. The 
value is in effect throughout the remainder of the SYSGEN 
process and cannot be redefined. 

=<progname> [<1egal args>] 

invokes a utility program (where <progname> is the name of the 
utility and <legal args> represents any command line input that 
is allowable for that utility). The utility cannot carry on an 
interactive dialog. Using this capability in the SYSGEN command 
file invokes the COPY utility with the append option to produce 
a single listing of all assemblies and links. 

forces SYSGEN to abort. 

specifies an assembler command line that causes ASM to be 
invoked. Using ASM causes a search for a file with the same 
name, but preceded with an X (a SUBSed file). If found, this 
"substituted" file will be assembled. This will not occur if 
■ASM is used, which invokes the assembler directly. 



ABORT 
ASM 



END 
ENDC 

EXCLUDE 

IFxx 

INCLUDE 
LINK 



ends previous task or process. 

terminates the conditional 
associated IFxx directive. 



processing associated with its 



specifies a segment of a process or task that is not loaded with 
the process or task. 

(where xx is EQ, NE, GT, LT, GE, or LE), initiates conditional 
processing. 

defines a file to be included in SYSGEN processing. 

specifies a source file that contains input to the linkage 
editor and invokes 4.INK. 
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MSG causes an operator message to be displayed at the relevant 
terminal . 

PAUSE halts SYSGEN execution until any character key is pressed. 

PC adjusts the location counter maintained during SYSGEN execution. 

PROCESS defines the beginning of a process stream of the type that 
results in a process being included in the output file. Also 
marks the end of the previous task or process if not completed 
by an END statement. 

SEGMENT defines the beginning of a segment stream of the type that 
results in a process being included in the output file. Also 
marks the end of the previous task or process if not completed 
by an END statement. 

SUBS indicates source file{s) where the values of SYSGEN defined 
parameters are substituted for the parameter names. 

TASK defines the beginning of a task stream of the type that results 
in a task being included in the output file. Also marks the end 
of the previous task or process if not completed by an END 
statement. 



3.2 NOTES ON SUBSTITUTION PROCESS 

SYSGEN provides flexibility through a two-step substitution process. 

3.2.1 SYSGEN Command File 

SYSGEN performs inline substitution for each command read from the command 
file. First the substitution is performed from the list of substitution 
parameters previously defined with the parameter command. After all the 
substitutions are made for that particular command, another pass is made on 
the command for substitutions from the ARG list previously defined from the 
ARG session control command. The command file itself is never changed; all 
substitutions are made on the memory image of the record after it is read from 
the file. After all substitutions are made, the command is processed. 

3.2.2 Filename Appearing on SUBS Command Line 

Here, substitutions are made in the records read from the file from the 
SYSGEN-maintained parameter list (built from previous parameter commands). 
Refer to paragraph 3.17 on the SUBS command for more detail on this process. 
No substitutions are made from the session control ARG list. 
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3.3 PARAMETER COMMAND 

A parameter remains in effect from the point it is defined until the end of 
SYSGEN execution. Only select parameters may be defined. Redefinable 
parameters are restricted to those specifying TCB information (covered later) 
and those parameters having an ampersand (&) as their first character. A 
redefinable parameter is one that can be defined at two or more different 
places within the SYSGEN command file. The value used is the one associated 
with the most recent definition. 



3.3.1 Parameter Command Syntax 



B 



<parameter name>=<value>[<space><comment>] 
<parameter name>=*[+<expression>] [<space><comment>] 



where: 
<parameter name> 



<value> 

* 

+ or - 
<expression> 



is the name by which the parameter is known and 
referenced. Maximum of eight alphanumeric characters plus 
ampersand (i), dollar sign ($), and period (.). One- 
character parameter names are invalid to avoid conflict 
with session ARG parameters. A parameter name that begins 
with an ampersand character is a redefinable parameter, 
i.e., it can appear more than once on the left side of a 
parameter command statement. It is similar in concept to 
the SET directive in the M68000-family assembler. The 
ampersand is part of the parameter name and counts as one 
character in the name. 

is a required delimiter. 

is an <expression>, a <string>, or a <literal>. 

is the current value of the SYSGEN location counter. 

is required if an <expression> follows. 

is an arithmetic expression involving hexadecimal and/or 
decimal constants and/or previously defined hexadecimal 
parameters. All arithmetic calculations are performed in 
integer mode. The operator precedence has multiplication 
and division as the highest priority, followed by addition 
and subtraction. Precedence of the same priority is from 
left to right. Use parentheses to alter the order of 
operations. 
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<string> 



EXAMPLE: $12*(4/(TAGl+TAG2))-2 

A dollar sign ($) preceding a constant indicates hex 
value. In the above expression example, if TAGl were 
previously defined as and TAG2 as 2, the expression 
value would be 34. This value is saved internally as the 
hexadecimal constant $22. Negative hex expressions are 
invalid, e.g., +-$23 and --$23 are invalid. 

is a string of up to 30 characters enclosed by single 
quotes. To encode a single quote in the middle of the 
literal, use two adjacent single quotes. The delimiting 
single quotes are saved as part of the symbol. 



EXAMPLES: 



•ABC 
'DON' 



<literal> 



is a string of up to 30 characters enclosed by double 
quotes {", or hex code $24). The 30 characters do not 
include the delimiting double quotes. The double quotes 
are not saved as part of the literal string. To encode a 
double quote in the middle of the string, use two adjacent 
double quotes. 



EXAMPLES: 



"LUSTRING" 
•AB""CDEF" 



<space> 
<comment> 



The backslash (\, or hex code $5C) cannot appear in any 
string because it is assumed to be a substitution sentinel 
and substitution is performed before processing by the 
parameter routine. 

represents a required blank space. 

is a string of characters (maximum of 80, less preceding 
characters on that command line). 



The value specified by a parameter command can be substituted in any source 
file that contains a parameter that matches <parameter name>. (Refer to the 
SUBS command.) 



EXAMPLE 



XX=10 
YY-$F0 
SS-' ABC 
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3.3.2 Special Parameters 

The SYSGEN utility reserves a few parameter names for specifying TCB 
information. Although these parameters have the same format, they are 
restricted to certain values. The SUBS command does not do value substitution 
for these parameter names. The five redefinable special parameters are: 









INITIAL 


PARAMETER 


MEANING 


VALID VALUES 


VALUE 


USER 


Task user number 


2 byte <number> 





SESSION 


Task session number 


4 byte <number> 





PRIORITY 


Task initial priority 


1 byte <number> 





STATE 


Task initial state 


<string> with a value of: 

'READ' (ready) 

'WAIT' 

'DORM' (dormant) 

'SUSP' (suspended) 


READ 


ATTRIB 


Task attributes 


<string> with a value of: 


'SYST' 
'CRIT' 






'SYST' System task 
'USER' User task 
'RTIM' Real-time task 
'CRIT' Task is critical 


to 
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'NOCR' 



operating system. If 
this attribute and the 
'SYST' attribute are in 
effect, the system will 
crash whenever the 
associated task aborts. 
Task is not critical to 
operating system. 



All task attributes and state settings revert to a default value whenever a 
new TASK command is encountered. The default values are: system task, 
critical and ready. To minimize the chance of setting the state or attributes 
wrong, use ATTRIB and STATE commands associated with the task immediately 
following the TASK command. A single ATTRIB command affects only one bit in 
the attributes word. Issuing multiple ATTRIB commands for the same task can 
affect more than one bit. 

NOTE: The STATE command, when issued for a particular task, will overwrite 
any of the information set up by a previous STATE command. Thus, only 
issue one STATE command for each task. However, SYSGEN does not 
enforce this rule. 
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The utility completely maintains six additional special parameters. The user 
cannot redefine these parameters. Only value substitution is allowed using 
the SUBS command. The DATE and TIME parameters are initialized from the 
system date and time when starting SYSGEN. 
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PARAMETER 
$TCBLST 

$TCBRDY 
$DATE 

$TIME 
$RA 

$RD 



MEANING 

Pointer used to maintain the list of TCBs. Each task is linked 
into this list and $TCBLST always contains the TCB address of 
the last task processed. 

Same as above but includes only tasks whose initial state is 
ready. 

Six-character ASCII date stored as a literal, yymmdd, where yy 
is the last two digits of the year, mm is the month, and dd is 
the day of the month. 

Four-character ASCII time stored as a literal, hhmm, where hh is 
the hour and mm is the minutes into the hour. 

16-bit binary abort code register. When a utility such as ASM 
or LINK aborts, $RA contains the abort code, obtained from the 
lower half of AO when the task aborts. 

16-bit binary diagnostic pseudo register. $RD contains the 
value that was in the upper 16 bits of DO when a utility such as 
ASM, LINK, or COPY terminates. This information normally 
reflects error and warning information similar to the RD pseudo 
register used in chainfile processing. This register can be 
tested within the SYSGEN command file. 



EXAMPLE 



ASM DRIVER,, DRIVER 
IFLE $COOO-\$RD 

PAUSE - ERRORS IN ASM 
ENDC 



In the above example, if the assembler terminated normally, the 
pause is not executed. If ASM had aborted, then the pause would 
have executed. Refer to the VERSAdos System Facilities 
Reference Manual, under the discussion of the CHAIN utility, for 
additional information on the RA and RD pseudo registers. 
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3.4 ABORT COMMAND 

The ABORT command forces the SYSGEN utility to abort. 
Syntax 

ABORT [comment] 

3.5 ASM (ASSEMBLE) COMMAND 

The ASM command allows one or more source files to be assembled and a 
relocatable module to be generated. Although no check is made, this feature 
is only useful if at least one source file had parameter substitution before 
the assemble request. The command should appear exactly as is required by the 
assembler. 

Syntax 

ASM <source file>,<object file>,<listing file>[;<options>] 

where: 

<source file>, <object file>, <listing file>, and <options> are as 
described in the M68000 Family Resident Structured Assembler Reference 
Manual . 

Before invoking the ASM command, SYSGEN searches for source file(s) with the 
specified name{s) preceded by X. If found, it uses the substitution file 
instead of the corresponding source file. This will not occur if you use the 
direct assembler command, =ASM. 

EXAMPLE 

ASM FMSREF.FMSREF,#PR1;R 

This command looks for the substituted filename of <system>.XFMSREF.SA first, 
and if found, assembles it (SYSGEN runs under catalog equal to the system 
type). 

3.6 END COMMAND 

The END command causes the processing of the previous task or process to be 
completed, or marks the end of the file. 

Syntax 

END [<comment>] 
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3.7 ENDC COHMAND 

The ENDC command must be paired with a previous IFxx command. Together, these 
commands define a block of commands that may or may not be processed, 
depending on the results of the IFxx command. 

Refer to the IFxx command description for an example. 

3.8 EXCLUDE COMMAND 

A segment name from the Loader Information Block (LIB) of a task or process 
can be specified on an EXCLUDE command line and can then be omitted from the 
output file portion for that task or process. 

Syntax 

EXCLUDE <segment name>[<space><comment>] 
where: 

<segment name> is the name of a segment to omit from the output file. 

Valid segment names are two, three, or four alphanumeric characters, and 
allow ampersand (&), period (.), and dollar sign ($). 

For one task or process, a maximum of four EXCLUDE commands can be specified. 
These must follow the corresponding TASK or PROCESS command and precede the 
terminating statement for that task or process. 

EXAMPLE 

EXCLUDE DSEG Exclude segment DSEG from the current 

process or task. 

3.9 IFxx COMMAND 

The IFxx command allows conditional processing of SYSGEN commands and must be 
paired with an ENDC command. 

Syntax 

IFxx <expression>[<space><comment>] 
where: 

XX is one of the following two-character strings: 
EQ, NE, GT, LT, GE, LE. 
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<expression> is a numeric expression consisting of SYSGEN substitution 
parameters, ARG substitution parameters, and/or hex and 
decimal constants. A carriage return or a blank terminates 
the expression. 

The expression is evaluated in a simple left-to-right scan, and obtains a 32- 
bit number. This number is compared to zero and then the xx-specified test is 
applied. If the test is true, processing continues in a normal manner. If 
the test is false, later command lines are not processed until the terminating 
ENDC command is found. Conditional tests may be nested to any depth. An 
expression may also be two strings or literals separated by a comma or a 
space. A comparison is made on a character basis between the two strings. 

EXAMPLE 

HDUDC0=4 
FDUDC0=2 
IFGT \HDUDCO+\FDUDCO 

TASK IPC,. IPC 

PRI0RITY=$D8 



ENDC 

SYSTYPE="EXORMACS" 

IFNE "\SYSTYPE", "VM02" 

MSG These commands would be processed 




ENDC 



Here, it would process all the statements between the IFNE and ENDC commands. 
If the expression contains parameter substitution sentinels, then the 
associated parameter must have been previously defined. 

3.10 INCLUDE COMMAND 

The INCLUDE command allows the user to include a secondary file in the source 
input stream. 

Syntax 

INCLUDE <filename> 

The next source stream images are taken from the file named on the INCLUDE 
statement. When that file is exhausted, processing resumes with the statement 
following the INCLUDE. Nesting of INCLUDE files is allowed (maximum of four). 
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3.11 LINK COMMAND 

The LINK command allows one or more relocatable modules to be linked together 
to produce a loadable module. 
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LINK <filename> 
where: 

<filename> is the name of a chainfile containing the -LINK command 
line followed by any linkage editor command input. The 
default extension is CF and the data in <filename> can be 
in the same format as a chainfile. The file is not 
actually processed as a chainfile, but merely passed to the 
linker as input. No commands other than comments beginning 
with =/* may appear in the link file befdre the -LINK 
command. 

If parameter substitution in <filename> is desired, precede the LINK command 
line with a SUBS <filename> command line. SYSGEN uses the substitution file 
(<filename> preceded by X) if one exists. 



EXAMPLE 

SYSGEN command file: 



Task stream name and start. 



TASK FMS 

FMSSTR" * (* represents the current value of the SYSGEN location 

counter.) 
SUBS FMSLNK.CF Make parameter substitution into FMSLNK.CF. 
LINK FMSLNK Link in module FMSLNK. 

Contents of the FMSLNK.CF file referenced on the file SUBS command line 
{before substitution): 

=/* COMMENTS MAY GO HERE (optional) 
=LINK ,FMS,#PR;IXHM {= is optional) 

SEGMENT 0:0 \FMSSTR 

INPUT FMS,FMSX 

END 
=END (optional line) 

Assuming the SYSGEN location counter had the value of $9C00 at the time FMSSTR 
was specified, the XFMSLNK file would be as follows after the SUBS is 
processed: 

=/* COMMENTS MAY GO HERE 

LINK, FMS, #PR;IXHM 

SEGMENT 0:0 $9C00 

INPUT FMS,FMSX 

END 

=END 
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3.12 HSG (MESSAGE) COMMAND 

The MSG command outputs text to the logon device. 

Syntax 

MSG <content> 
where: 

<content> is a string of characters (maximum of 75). 

EXAMPLES 

MSG REMOVE VOL 1 

MSG MOUNT VOL 2 

MSG DEPRESS RETURN WHEN READY 



3.13 PAUSE COMMAND 

The PAUSE command temporarily halts SYSGEN. Execution continues when any 
character key (other than BREAK) is pressed. 

Syntax 

PAUSE [<comment>] 



3.14 PC COMMAND 

The PC command allows the user to alter the location counter maintained by the 
utility. This counter determines the destination memory locations in the 
output file. 

Syntax 

PC = *[<space><comment>] 

PC « *+<expression>[<space><comment>] 

PC = <expression>[<space><comment>] 




where: 



is the current value of the SYSGEN location counter. 
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+ causes the following value to be added to the value of the 

current location counter. 

<expression> is a string of hex or decimal digits, up to a maximum of 10 
characters, including $. If specified, it must be on a 
page (256 byte) boundary. 

The new value of the location counter must be equal to or greater than the old 
value. The new PC value is sent to the list device. On startup, the counter 
value is initialized to zero and updated as tasks and processes are written to 
the output file. If the user changes the location counter value, SYSGEN 
writes zeros to the output file from the old value up to the new value unless 
the PC command precedes any TASK, PROCESS, or SEGMENT commands. In that case, 
zeros are not written to the output file. Instead, the new PC value becomes 
the starting address of the data in the boot file. 

3.15 PROCESS COMMAND 

A process stream causes a load module to be processed. After SYSGEN 
tailoring, the result is a module that is included in the output file. The 
module is transformed into supervisor mode suitable for executive or driver 
type application. 

Svntax 

PROCESS <filename>[<space><comment>] 
where: 

<filename> is the name of the file containing the load module. 

All commands between the PROCESS command and the next END, PROCESS, SEGMENT, 
or TASK command or end of file constitute a process stream. 

Since the process runs in supervisor mode and the MMU is not available, a 
process must be written to the output file at the address specified in its 
Loader Information Block (LIB). Therefore, if SYSGEN's location counter is 
less than the starting address of the process, zeros are written to the output 
file until the location counter equals the starting address. An error occurs 
if the location counter is greater than the process starting address. 

The load address of the last process in the SYSGEN command file is inserted in 
the restart vector (offset 4) of the boot file. 



EXAMPLE 



PROCESS EXEC Process the load module EXEC in supervisor 

mode. 
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3.16 SEGMENT COMMAND 

The SEGMENT command allows a segment of a load module to be specified for 
inclusion in the boot file as a process. 

Syntax 

SEGMENT <filename>,<segment name>[<space><comment>] 

where: 

<filename> is the descriptor of the load module file containing 
<segment name>. The minimum required is the filename 
field. The default extension is LO. 

<segment name> is the name of the segment to be included in the boot file. 

Valid segment names are two, three, or four alphanumeric 

characters, with ampersand {&), period (.). and dollar sign 
($) allowed. 

All commands between the SEGMENT command and the next END, SEGMENT, PROCESS, 
or TASK command constitute the segment stream. 

The address of the specified segment in the LIB of the load module is ignored. 
Instead, the segment is included in the boot file at the address provided by 
the SYSGEN location counter when the SEGMENT command begins execution. A 
process generated in this way (by SEGMENT command execution) is not used as a 
startup address. 



3.17 SUBS (SUBSTITUTION) COMMAND 

The SUBS command allows the values of parameters to be substituted in a source 
file referenced by the SYSGEN command file. 

Syntax 

SUBS <filenamel>[,<filename2>...,<filenamen>] 

where: 

<filenamen> is the name of a source file where parameters are to be 
substituted. Default extension is SA. Multiple filenames, 
separated by commas, can be specified. 

The SUBS command reads the specified source file, examining each record. 
Whenever a backslash is encountered, the characters that follow are examined 
to determine if they match the name of a SYSGEN parameter. (A backslash 
followed by just one of the characters 0-9 and A-Z is ignored.) If no 
parameter by that name exists, an error is logged. The utility copies the 
source file records with any indicated substitutions made to an output file. 
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The new file is given the name of the source file preceded by an X. The 
filename portion of <filenamen> is a maximum of seven characters, instead of 
the usual eight. 

EXAMPLE 

SYSGEN command file contains: 

N0DISK=4 

Parameter command lines 
DEFVOL='BOOT' 

SUBS FMSREF 

FMSREF contains: 

* SET UP SPACE BASED ON NO. OF DISKS IN SYSTEM 

DS.B \N0DISK*50 
SYSDEF EQU \DEFVOL SYSTEM DEFAULT VOLUME 

The resulting source file XFMSREF contains: 

* SET UP SPACE BASED ON NO. OF DISKS IN SYSTEM 

DS.B 4*50 
SYSDEF EQU 'BOOT' SYSTEM DEFAULT VOLUME 

The ASM command assembles the new file (refer to paragraph 3.13). 

3.18 TASK CONHAND 

A task stream causes a load module to be processed. After SYSGEN tailoring, 
the result is normally a task that is included in the output file. 

Syntax 

TASK <filename>[,<taskname>][<space><comment>] 



where: 



<filename> is the name of the file containing the load module. The 
default extension is LO. 
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<tasknatne> is the name of the task. Overrides the name generated by 
the linkage editor. Valid tasknames include two to four 
alphanumeric characters, with ampersand {&), period (.). 
and dollar sign {$) allowed. 



All commands between the TASK command and the subsequent END, TASK, SEGMENT, 
or PROCESS command or end of file constitute a task stream. The task starts 
at the address indicated by the current SYSGEN location counter unless the P 
option was specified. If the P option was specified on the SYSGEN command 
line, there is no MMU, and the task is located in the output file at the 
address specified in the loader information block of the task. Therefore, if 
the SYSGEN location counter value is less than the starting address of the 
task, zeros are written to the output file until the SYSGEN location counter 
value is equal to the starting address of the task. An error occurs if the 
location counter is greater than the task starting address. 




EXAMPLES 

TASK FMS,.FMS 

TASK PROG. 10 



Process the load module FMS.LO and rename 
the task to .FMS. 

Process the load module PROG.LO. The 
taskname remains that as defined by the 
linker. 



3.19 OTHER EXECUTABLE COMMANDS 

By coding a command line preceded by "-" within the command file, any non- 
interactive utility program may be invoked from within SYSGEN. The utility 
runs the same as if it had been invoked from within a chainfile. (Refer to 
paragraph 3.1.) 

3.20 SYMBOL UTILITY (SGSYMBL) 

The SGSYMBL SYSGEN pass two processor generates a cross-reference listing file 
of the parameters used during a SYSGEN. The input for this utility is the 
file SGSYMS.SY under the user's current defaults. The output is the file 
SYMBOLS. LS under the user's current defaults. The file SGSYMS.SY must have 
been created by the SYSGEN utility with the C option specified at SYSGEN time 
or by the STD. SYSGEN. CF chainfile. The information in the SGSYMS.SY file is: 

a. The parameter name 

b. The value for the parameter 

c. The file(s) that define the parameter 

d. The file(s) that reference the parameter 
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See Figure 3-1 for an example of the listing. During its operation, SGSYMBL 
displays the number of the symbol that is currently processing. In the 
"Referenced in file(s)" column there may be filenames followed by a number in 
brackets, which is the number of times that symbol was referenced from that 
file, or the filename may print more than once. 



=SGSYNBL 
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CHAPTER 4 
SYSGEN RON CAPABILITY 



The ROM capability associated with the SYSGEN process allows the user to build 
a ROMed system that includes the RMS68K kernel, user-written applications 
programs, and that portion of VERSAdos functionality that allows device 
assignment and access. File management, the loader, and session control are 
not included in the ROM capability. The user can write applications in 
assembly language or Pascal language (modified version 2.3). Multiple Pascal 
programs in the same ROM system can share the same run-time library code, 
minimizing ROM space requirements. 

In user number 9990 a chainfile exists, ROM. EXAMPLE. CF, that will create a ROM 
product using a Pascal task that can be executed on an MVMEllO system. The 
file contains detailed instructions, including logon and invocation 
procedures. 

The general steps for creating a ROM system discussed in detail in this 
chapter are: 

a. Create an RMS at the desired ROM start address. 

b. Invoke the appropriate COPYSGEN chainfile to accumulate the SYSGEN 
files into the desired user number. 

c. Modify the files related to the ROM capability. 

d. Create and insert an application INCLUDE file. 

e. Select, via switch settings, the required drivers for the user 
application. 

f. Start the SYSGEN. 



4.1 GENERAL RON SYSGEN CONSIDERATIONS 

This SYSGEN example is for an MVMEllO system and assumes that the files have 
been modified for the configuration of the user's system. The values used are 
not binding. The catalog field typically represents the <system> (VMEllO, 
VME120, VM02, etc.), for the target SYSGEN. 

1. Modify the VMEllO.RMS.CD file value "RMS" to the desired user starting 
ROM address. This dynamically defines the value "ROMSADDR" which is 
the ROM start address. The user should ensure that there is no 
conflict between RAM and ROM partitioning in the command INCLUDE file 
VMEllO. SYSTEM. CI (refer to step 3c.). 
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BEFORE: 



AFTER: 



RMS 



$40000 Address where RMS68K starts. 



RMS = $300000 Address where RMS68K starts. 



Now start an RMS SYSGEN in user number 9999, to create the ROMable RMS 
at the selected ROM start address. The files generated by the RMS 
SYSGEN that will be used in the product SYSGEN are VMEllO.RMS.LO, 
VMEllO.RMS.LL, and VMEllO.RMS.CI. These files are automatically 
copied into the target user number where the system SYSGEN will occur 
when the system COPYSGEN is started. Invocation of an RMS SYSGEN is 
done by the command line RMSGEN.CF <system>. Thus, for an MVMEllO 
system, the user would input RMSGEN.CF VMEllO. 

Copy, using the VMEllO. COPYSGEN. CF file, those files that are used to 
create the VMEllO. VERSADOS.SY module. The parameters required to 
start the VMEllO. COPYSGEN. CF file are documented in the file. It is 
the user's responsibility to copy the user-written SYSGEN application- 
related files because this file will not copy them. 

Modification of the following files must occur before initiating the 
SYSGEN for the target system: 

a. &. SYSGEN. CF 

This change requests the SYSGEN process to create a ROMable 
product. 

BEFORE: =SYSGEN \5,\6,\7;CT=350 

AFTER: =SYSGEfl \5,\6,\7;CT350,R 

b. &.CNFGTASK.CI 

This change removes the File Management System (FMS), the 
Exit/Entry Task (EET), and the Loader (LDR) from the SYSGEN 
product. 

BEFORE: 

FMS$ = 1 Set =0 for skip FMS module, not =0 to include it 
EET$ = 1 Set =0 for skip EET module, not =0 to include it 
LDR$ = 1 Set =0 for skip LDR module, not =0 to include it 

AFTER: 

FMS$ = Set =0 for skip FMS module, not =0 to include it 
EET$ = Set =0 for skip EET module, not =0 to include it 
LDR$ = Set =0 for skip LDR module, not =0 to include it 

c. VMEllO. SYSTEM. CI 

This change establishes the ROM ending address. The ROM ending 
address should be at least large enough to accommodate the ROM 
product being produced. 
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The user should make sure that the ROM start/end addresses do not 
conflict with the "MEMEND" addresses that are in this file. The 
ROM start address was established in step 1. The "MEMEND" 
addresses for the MVMEllO are: 



BEFORE: 

ROMEADDR = ROM end address defined by the user for a 
ROMable system. (The ROM start address 
(ROMSADDR) is defined in the VMEllO.RMS.CI file 
and has a value equal to the initial program 
counter.) 

MEMENDl = $200000 Ending address for onboard memory must be lower 
than (<) this. 

MEMEND2 = $00000 Starting address for offboard memory must be 
greater than or equal to (>=) this. (Not 
applicable for an MVMEllO.) 

MEMEND3 = $00000 Ceiling address for offboard memory must be 
lower than (<) this. 



H 



AFTER: 



ROMEADDR 



$313200 ROM end 
ROMable 



address defined by the user for a 
system. (The ROM start address 
(ROMSADDR) is defined in the VMEllO.RMS.CI file 
and has a value equal to the initial program 
counter.) 

MEMENDl = $200000 Ending address for onboard memory must be lower 
than (<) this. 

MEMEND2 = $00000 Starting address for offboard memory must be 
greater than or equal to (>=) this. (Not 
applicable for an MVMEllO.) 

MEMEND3 = $00000 Ceiling address for offboard memory must be 
lower than (<) this. 

&.VERSADOS.CD 

The application INCLUDE file created by the user should be 
inserted (example follows). Refer to Appendix E for an example of 
application INCLUDE files for an assembly task and a Pascal task. 
Application tasks should have a priority less than the File 
Handling Services (FHS) or the Input/Output Services (lOS). This 
is done by using the PRIORITY SYSGEN command. If the application 
INCLUDE file is for an assembler source, the application task 
should issue a Relinquish directive before soliciting the services 
of FHS and/or lOS to ensure the completion of their 
initialization. The Pascal initializer does this function for 
Pascal source. 
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BEFORE: 

IFNE \FHS$IOS$ 

MSG 

^5Q ************************************************** 

MSG ** System I/O Initializer 

f(5Q ************************************************** 

INCLUDE &.IOI.CI 

AFTER: 

INCLUDE &.APLICATN.CI 

IFNE \FHS$IOS$ 

MSG 

|l^5Q ************************************************* 

MSG ** System I/O Initializer 

mgQ ************************************************* 

INCLUDE &.IOI.CI 

e. VMEllO.CNFGDRVR.CI 

This file must be modified by the user to select, via switch 
settings, the drivers required for the user application. With 
each <system>.CNFGDRVR.CI file there are certain default driver 
configurations. If the user does not modify this file, drivers 
not applicable to the application are included in the ROM product 
and never used. 

4. Copy the user-created application-related files to the target SYSGEN 
user number. 

5. After examining the file STD. SYSGEN. OF, establish the appropriate 
parameter and invoke the SYSGEN process using this chainfile. 

6. The <system>.VERSADOS.SY created by the SYSGEN process can now be 
burned into ROM using the selected ROM chips and module. 

7. Invocation procedures for the ROM product are: 

a. Press the RESET button. 

b. Set the program counter to the SYSTEM STARTUP ADDRESS established 
at the end of the system listing generated by SYSGEN (refer to 
Appendix F). 

c. Enter G followed by a carriage return. 

d. The application is now set up and ready to run. 
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This procedure works on any system. However, the user may want 
control transferred directly to the user application when the RESET 
button is pressed. This is done by replacing the bug PROMs with a set 
of dummy PROMs that contain two long words. The two long words 
contain the starting system stack address and the SYSTEM STARTUP 
ADDRESS, respectively. The starting system stack address is found in 
the VMEllO.RMS.CI file. 

4.2 PASCAL ROM CONSIDERATIONS 

Minor modifications were made to the Pascal version 2.3 run-time library 
routines to support the ROM capability. The standard Pascal run-time library 
will not support ROM. The modified modules are identified by the catalog of 
"RROM". 

4.2.1 Pascal Initializer 

The Pascal initializer was removed from the library and is now linked with the 
Pascal task at SYSGEN time. It is no longer position independent and forces 
the data segment associated with the Pascal task to be dynamically obtained. 
A Relinquish directive is issued to ensure that FHS and lOS have completed 
their initialization before accessing their services. Access of a module is 
also done by the initializer to assign logical units 5 and 6 as required by 
the Pascal task. 

4.2.2 RON Libraries 

Two ROM shareable libraries have been created; one that supports floating 
point processing (RROM.RLIBFP.RO), and one with no floating point processing 
(RROM.RLIBNFP.RO). The library that contains floating point is about 30Kb in 
length, while the library without floating point is about lOKb in length. The 
chainfiles RROM.RLIBFP.CF and RROM.RLIBNFP.CF can be used to build the 
floating point and non-floating point libraries. 



D 



4.2.3 Nodule RRON.ASSIGNLU.SA 



4.2.3.1 Logical Units 5 and 6 Assignment . The Pascal compiler treats "INPUT" 
and "OUTPUT" references on the PROGRAM statement in a special way. Typically 
"INPUT" refers to the terminal keyboard and "OUTPUT" refers to the terminal 
screen. These logical unit assignments are normally handled by the Exit/Entry 
Task (EET). EET has been removed from the system and the module 
RROM.ASSIGNLU.SA has been created to do this assignment. 

This module contains instructions as well as examples on how to modify the 
command line for terminal assignments. 



39 



MICROSYSTEMS 



® 



MOTOROLA 



SYSGEN ROM CAPABILITY 



4.2.3.2 Pascal Command Line . The RROM.ASSIGNLU.SA module also has a minimum 
command line that is ";Z=1" followed by a carriage return. This command line 
forces Pascal to obtain a new data segment dynamically for the Pascal task. 
It can also be used to specify device names or other options to allow run-time 
flexibility. The following example shows a Pascal task using the minimum 
command line: 



UNALTERED COMMAND LINE USAGE 



B 



PROGRAM 


ptask{output); 


VAR i 


: integer; 


VAR a,b 


c : real ; 


devpr 


: text; 


BEGIN 




rewrite 


(devpr, '#PR'); 


i := 1; 





WHILE i <> 10 DO 
BEGIN 

writeln (devpr,' MOTOROLA MOTOROLA MOTOROLA '); 
i := i+1; 
END; 



1; 

3.14159; 

2.71828; 



WHILE 1=1 DO 
BEGIN 
writeln ( i, ' 



1 
b 
c 
END; 

END. 



i+1; 

b+0.035; 
b*a; 



MOTOROLA MOTOROLA MOTOROLA ',c: 10:5); 



40 



MICROSYSTEMS 



(g) MOTOROLA SYSf^EN ROM CAPABILITY 



An altered command line using "#PR,;Z=1" followed by a carriage return channoe 
the "PROGRAM" line and the "REWRITE" line. An example of a Pascal task usina 
this task is: ^ 

ALTERED COMMAND LINE USAGE 

PROGRAM ptask(output,devpr); 



VAR i 
VAR a,b,c 
devpr 



integer; 
real ; 
text; 



BEGIN 

rewrite (devpr); 

i := 1; 

WHILE i <> 10 DO 
BEGIN 

writeln (devpr,' MOTOROLA MOTOROLA MOTOROLA '] 
i := i+1; 
END; 



D 



= 1; 

= 3.14159; 

= 2.71828; 



WHILE 1=1 DO 
BEGIN 

writeln ( i, ' MOTOROLA MOTOROLA MOTOROLA ',c: 10:5); 
i := i+1; 
b := b+0.035; 
c := b*a; 
END; 

END. 



The RROM. ASSIGNED. SA source module has a detailed description of how these 
functions can be used. 



4.2.4 Shareable Run-Time ROM Library 

The library link modules establish the shareable run-time ROM library. Both a 
floating point and a non-floating point version of easily modified standard 
link chainfiles are provided. The floating point modules are RROM.TASKFP.LG 
and RROM.RLIBFP.LG while the non-floating point modules are RROM.TASKNFP.LG 
and RROM.RLIBNFP.LG. The task link modules include the selected shareable 
run-time ROM library so that external references can be satisfied, but the 
segment containing the ROM library has been excluded from the task link at 
SYSGEN time. Refer to Appendix E for the segment exclusion. See Figure 4-1 
for the standard link modules. 
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RROM.RLIBFP.LG 

=/* 

=/* 

=/* RROM.RLIBFP.LG Chainfile to link globally shareable Pascal 

=/* run-time routines. These run-titne routines 

=/* INCLUDE floating point. 

=/* 

=/* 

=LINK ,RROM.RLIBFP.LO,\LINKLS;HAMIXSZ=100 

SEG SEG0{RG):8 \GSPLSTR 
INPUT RROM.RLIBFP.ro 
END 

RROM.TASKFP.LG 

=/* 

=/* RROM.TASKFP.LG Chainfile to link globally shareable Pascal 
=/* run-time routines to a user task. The run-time 

=/* routines INCLUDE floating point. 

=/* 

=/* The following SYSGEN link file can be used by the user by 

=/* changing only the name of the applications task '????' where 

=/* referenced. NOTE that the library modules are 'INCLUDEd', 

=/* not 'LIBed'. This is necessary to properly satisfy external 

=/* references with a shared library. 

=/* 

=/* 

=LINK ,&.????. LOALINKLS;HAMIXSZ=IOO 

SEG PR0G(R):9 \PC 
SEG SEG0(RG):8 \GSPLSTR 
SEG SEG2(R):15 
IN &.????. RO 

IN rrom.init.ro 
IN rrom.assignlu.ro 
IN rrom.rlibfp.ro 

END 
=END 

rrom.rlibnfp.lg 

=/* 

=/* 

=/* rrom.rlibnfp.lg chainfile to link globally shareable Pascal 

=/* run-time routines. These run-time routines 

=/* DO NOT INCLUDE floating point routines. 

=/* 

=/* 

=LINK ,RR0M.RLIBNFP.L0ALINKLS;HAMIXSZ=100 

SEG SEG0(RG):8 \GSPLSTR 

INPUT RROM.RLIBNFP.ro 

END 

FIGURE 4-1. Pascal Task ROM-Related Link Files 
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RROM.TASKNFP.LG 

=/* 

=/* RROM.TASKNFP.LG chainfile to link globally shareable Pascal 

=/* run-time routines to a user task. The run- 

=/* time routines DO NOT INCLUDE floating 

=/* point. 

=/* 

=/* The following SYSGEN link file can be used by the user by 

=/* changing only the name of the applications task '????' where 

=/* referenced. NOTE that the library modules are 'INCLUDEd', 

=/* not 'LIBed'. This is necessary to properly satisfy external 

=/* references with a shared library. 

=/* 

=/* 

=LINK ,&.????.LO,\LINKLS;HAMIXSZ=100 

SEG PROG (R): 9 \PC 

SEG SEGO {RG):8 \GSPLSTR 

SEG SEG2(R):I5 

IN &.????. RO 

IN rrom.init.ro 
IN rrom.assignlu.ro 
in rrom.rlibnfp.ro 

END 
=END 

figure 4-1. Pascal Task ROM-Related Link Files (cont'd) 



4.2.5 Floating Point Nodules 

Floating point modules have been modified to remove references to external 
definitions defined at compile time. For the non-floating point library, 
there is a reference to an external definition in a floating point module. To 
satisfy this reference, the dummy module RROM.FPPOINT.SA was created. This 
module, which should not be referenced because the user application does not 
use floating point processing, contains the required external definition and 
an illegal instruction for diagnostic purposes. 
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4.3 ADDITIONAL PROCEDURES FOR THE PASCAL USER 

In addition to the general ROM procedures, the Pascal user should also: 

a. Copy RROM.ASSIGNLU.SA and RROM.ASSIGNLU.AF to the SYSGEN target user 
number. Modify as required and assemble RROM.ASIGNLU.SA, using the 
RROM.ASSIGNLU.AF chainfile. 

b. Decide which run-time shareable ROM library to use, floating point or 
non-floating point. If floating point is selected, copy 
RROM.RLIBFP.ro and RROM.TASKFP.LG to the target SYSGEN user number. 
If non-floating point is selected, copy RROM.RLIBNFP.RO and 
RROM.TASKNFP.LG. to the target SYSGEN user number. The user should 
modify the ".LG" file by changing "????" to the Pascal taskname (see 
Figure 4-1). 

c. Build the Pascal application INCLUDE file into the SYSGEN target user 
number using the selected floating point or non-floating point link 
files. The application INCLUDE file in Appendix E can be used as a 
guide. 

d. Copy RROM.INIT.ro to the target SYSGEN user number. 

e. Copy the Pascal application-related files to the target SYSGEN user 
number. 
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APPENDIX A 
VERSAdos - I/O RELATED CONTROL BLOCKS AND TASKS 

A.l USING THE SYSTEM MAP 

The last thing in the SYSGEN print file is a map of the generated system. It 
shows the various tasks and processes present in the system when booting is 
complete, and the initial address where execution is to start. Appendix C 
shows a typical SYSGEN map. Referring to that example, the column "TASK" 
shows the various tasks in the system at the time it is booted. The TCB 
column shows the address in memory of the TCB for the task. After the system 
is booted, a task's state and priority is controlled by the SYSGEN STATE and 
PRIORITY parameters. 

Each task can be made up of one or more segments, whose names are shown in the 
"SEG" column and whose addresses are shown in the "ADDR" column. The segment 
names are those given by the linkage editor when building the load module used 
to create the task. 

Some load modules create processes instead of tasks. A process is a 
collection of instructions and data that is not represented by a TCB. Two 
processes are shown -- RMS and SYSINIT. RMS is RMS68K, which serves as the 
VERSAdos kernel. SYSINIT is system initialization, entered as soon as the 
entire system is booted. Note that the startup address is the beginning of 
SYSINIT. When SYSINIT is completed, it JUMPs to the dispatcher to start 
system processing. The memory used by SYSINIT is not allocated to any task 
and becomes available for system use as soon as SYSINIT is completed. 

The addresses shown in the "ADDR" column are the actual addresses where the 
system is loaded as long as WHERLOAD is set to zero. For a VMOl system, 
WHERLOAD is set to load the system into offboard RAM. However, the first 
thing SYSINIT does is to relocate the loaded system into onboard RAM, making 
the addresses match unless the R option (ROMable) was specified on the SYSGEN 
command line. SYSINIT then continues in the relocated code. 

A. 2 THE .101 TASK 

When INT completes, and turns control over to the dispatcher, the highest 
priority ready task is .101, the I/O initializer. It is made up of two 
segments: .101 and lOSG. Entry is into module lOI (part of segment .101), 
which sets the I/O system in motion. Its processing is broken down into four 
steps: 

a. Allocate all channels. This uses the Channel Data Blocks (CDBs) 
assembled in SECTION 1 of the IOC assembly, and included as part of 
the .101 segment. The macro CDB generates the Channel Control Blocks 
(CCBs). CDBs are only needed during I/O initialization. 
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Bb. Calculate, and save for step d, various data lengths. These include 
the data segment for FMS for its stack, Volume Descriptor Tables 
(VDTs), File Control Blocks (FCBs), and File Assignment Tables (FATs). 

c. Declare segment lOSG shareable. 

d. For each I/O system task: 

1. Grant shared access of segment lOSG to the task. 

2. Allocate an Asynchronous Service Queue (ASQ) for the task if 
requested. 

3. If a data segment is requested, get a data segment for the task, 
clear it, declare it shared, and transfer it to the task. 

4. Start the I/O system task according to the startup priority task 
(make it ready to run). 

Task .101 then terminates. Segment .101 disappears with the task termination, 
but lOSG remains because it has been made shareable and is now being used by 
the various I/O tasks. 

A. 3 THE lOSG SEGMENT 

lOSG is section of assembly XIOC (or XVMIOC). It starts out as part of task 
.101, but is given to all the I/O tasks (as described in the previous 
subsection) before .101 completes. At label lOCOMS in the assembly is a table 
of pointers and values. This table is at the beginning of the module and is 
called the System Value Table (SVT). Two sets of three pointers are of 
interest here: 

OFFSET POINTER 

$10 Start of Logical Unit Table (LUT) space 

$14 End of LUT space 

$18 First LUT in chain of active LUTs 

$1C Start of Device Control Block (DCB) space 

$20 End of DCB space 

$24 First DCB in chain of active DCBs 

To verify that it is the right memory location, check offset $2C. This should 
contain VERSADOSREV. 

A. 4 THE LOGICAL UNIT TABLE 

Each task has an associated LUT. Active LUT entries are in a chain whose head 
is at the SVT+$18. SYSGEN reserves enough space for a LUT for each task 
(NOTASKS), with each table having room for information about one more than the 
maximum number of logical units available to each task (MAXLU). Logical unit 
zero is reserved for system use. 
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Each LUT consists of a 16-byte long header followed by multiple 8-byte 
entries. Each 8-byte entry corresponds to one possible logical unit. Figure 
1 shows the format of the LUT. 




SYMBOL OFFSET 



LENGTH 



LUTPTR 





($0) 


4 


LUTTID 


4 


($4) 


4 


LUTSES 


8 


($8) 


4 


LUTMLU 


12 


($C) 


1 


LUTCAS 


13 


($D 


1 


LUTUNM 


14 


($E) 


2 


LUTBEG 


15 


($10) 





LUTCAP 


16 


($10) 


1 


LUTCSF 


17 


($11) 


1 


LUTATT 


18 


($12) 


2 


LUTDCB 


20 


($14) 


4 



FIELD 

Pointer to next table 

Taskname 

Task session 

Maximum number of LU entries 

Number of current assignments 

User number 

Start of LU entries 

LU entry first 

Current access permission 

Current status flag 

Attributes of device/file 

Address of connected DCB/FCB 



- Current 


access 


permission (LUTCAP) 


Symbol 


Value 


Meaning 


FOPPR 





Public read 


FOPER 


1 


Exclusive read 


FOPPW 


2 


Public write 


FOPEW 


3 


Exclusive write 


FOPPRPW 


4 


Public read-write 


FOPPREW 


5 


Public read, exclusive write 


FOPERPW 


6 


Exclusive read, public write 


FOPEREW 


7 


Exclusive read-write 


- Current 


status 


flag (LUTCSF) 


Symbol 


Bit 


Meaning 


LUSFAC 





Active LU entry 


LUSFIO 


1 


I/O pending 


LUSFCP 


2 


Close pending 


LUSFAS 


3 


Assign pending 


LUSFCW 


4 


Connection wait 


LUSFDV 


7 


Device assignment 


- Attribu 


tes of device/file (LUTATT) - same as DCBATT 



FIGURE 1. Format of the Logical Unit Table 
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The LUT for a particular session and task can be found by following the chain 
of active LUTs, starting with the first one (pointed to by SVT+$18), and 
continuing by using the link pointer at offset $0 in the LUT. Look for the 
proper taskname and session number. When it is found, the entries for each 
logical unit can be examined. Unassigned logical units contain zero in the 
LUTDCB field. Also, bit LUSFAC of byte LUTCSF is zero. The current status of 
other active entries can be checked in byte LUTCSF. 

Bit LUSFDV indicates whether the LUT represents a file assignment or a device 
assignment. If it is on, it represents a device assignment. The field LUTDCB 
points to a DCB for a device assignment and to a File Control Block (FCB) for 
a file assignment. 

A. 5 COMMUNICATION BETWEEN USER TASKS AND THE I/O SYSTEM 

User tasks request service from the I/O system by using either a TRAP #2 or a 
TRAP #3. TRAP #3 requests service from File Handling Services (FHS), which 
runs as task .FHS. FHS handles file and device manipulation, such as 
allocation, assignment, and renaming. Refer to the VERSAdos Data Management 
Services and Program Loader User's Manual for details on the types of requests 
available. 

TRAP #2 requests I/O operations on files or devices. Input/Output Services 
(lOS), which runs as task .lOS, handles these requests. Refer to the VERSAdos 
Data Management Services and Program Loader User's Manual for details on types 
of requests available. 

These two traps are passed to FHS and lOS because the tasks declare themselves 
handlers of the traps when execution starts. After initialization, all 
execution in FHS and lOS occurs when issuance of the appropriate trap causes 
RMS68K to place a user/server event (code 7) in their event buffer. 
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B.l DESCRIPTION OF DEVICE CONFIGURATIONS 

In most instances, it is sufficient for the user to alter the parameters in 
the SYSGEN configuration switch file. However, occasionally it may be 
necessary to make changes to the Device Control Blocks (DCBs) or Channel Data 
Blocks (CDBs). A DOB is provided for each device generated in the system and 
contains device dependent information about each device. CDBs contain 
information regarding each channel that is used to build the Channel Control 
Block (CCB) when the channel is allocated. Information regarding the DCBs and 
CDBs is found in the files IOC.<driver name>.AG, where the driver name is 
MxxxDRV for VME boards (e.g., M320DRV) or <chip_name>DRV for chip drivers 
(e.g., ACIADRV). A DIR IOC*. AG command lists all drivers available in the 
SYSGEN account number. The DCBs and CDBs are configured automatically 
according to the SYSGEN parameters and become part of a common I/O segment 
accessible to all I/O tasks. 

It is also possible to reconfigure certain device parameters and attributes 
without reSYSGENing the system by using the configuration utility, CONFIG. 
The types of devices that may be reconfigured are: 

a. Terminals 

b. Magnetic tape drives 

c. Printers 

The number of each type of device that may be configured by CONFIG is limited 
by the number allowed by the current VERSADOS.SY file (these quantities are 
determined by examining the <system>.CNFGDRVR.CI file from which VERSADOS.SY 
was SYSGENed). If more devices are to be added to the system, the 
<system>.CNFGDRVR.CI file must be altered and a SYSGEN performed to create a 
new VERSADOS.SY. Refer to the M68000 Family VERSAdos System Facilities 
Reference Manual and the VERSAdos to VME Hardware and Software Configuration 
User's Manual for more details. 

Assumptions made about hardware configurations and device mnemonics are: 

a. If there are any Multi-Channel Communications Modules (MCCMs) in the 
system, the physical address of the first board is assumed to be 
SFFIOOO, and each additional MCCM is assigned to physical address $200 
bytes greater than the previous. The device mnemonics corresponding 
to the terminals on the first MCCM are CNIO, CNll, CN12, and CN13. 
Mnemonics for terminals on the second MCCM are CN2x, etc. 
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b. Remote terminals interfaced through the MVME400 module and printers 
interfaced through the MVME410 module have dynamic addresses via the 
The general format of these addresses is $F80JJA 
"J" implies that these digits depend on the jumper 
digits "A" and "B" represent Ports A and B, 
addresses for all I/O Channel devices are defined 
as offsets from the I/O Channel Base Address 
(lOCBASE) as defined in <system>. SYSTEM. CI. The addresses for the 
boards on the short I/O address space are defined in SIO.ADDRESS.CI as 
offsets from the Short I/O Base Address (SIOBASE). They are defined 
as channel addresses rather than bus addresses so that there is a 
direct correspondence to the addressing information in the board 
manual . 



jumper capability, 
and $F80JJB where 
placement and the 
respectively. The 
in IOC. ADDRESS. CI 



c. Device mnemonics for printers are dependent on the location of 
printers specified at SYSGEN. The names generated are: 

PR, PRl, PR2, PR3, and PR4 



The order in which names are defined is: 



EXORmacs 

Local printer = PR 
1st MCCM = PRl 
2nd MCCM = PR2 
3rd MCCM = PR3 
4th MCCM = PR4 



VMC 68/2 

1st MVME410 parallel port = PR 

2nd MVME410 parallel port = PRl 
1st MCCM = PR2 



VME/10 

1st MVME410 parallel port = PR 
2nd MVME410 parallel port = PRl 



If SYSGEN specifies printers, the default device mnemonics are PR, 
PRl, PR2, PR3, PR4, respectively, and are assigned as needed (refer to 
the table above) . 

d. All printers are software-configured as low-speed printers. If the 
spooler task is running in the system, data directed to a printer is 
directed to a spooler file first and then output to the printer. 
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The device address of the first Floppy Disk Controller (FDC), 
Universal Disk Controller (UDC), or VM22 Intelligent Peripheral 
Controller (IPC) is assumed to be $FFOOOO. Each subsequent FDC, UDC, 
or VM22 IPC has an address $200 bytes greater than the previous. If 
only floppy disk drives on FDCs are configured in the system, they 
should be configured at addresses $FFOOOO and $FF0200. The same 
configuration would be used if only UDCs or VM22 IPCs are used. 
However, for a combination of FDCs, UDCs, and/or VM22 IPCs the boards 
should be alternated, with a UDC being assigned to $FF0000. 

The device mnemonics for disk drives are determined as follows: 

1. The first two characters are: 

HD (if hard disk). 
FD (if floppy disk). 

2. The third character indicates the FDC or UDC controller board 
number (0-3). 

3. The fourth character indicates the device number within the 
FDC (0-3) or UDC (0-7), or VM22 IPC (0-B). 

Floppy disk drives configured on a UDC begin with a device number of 
four, regardless of the number of hard disk drives also configured on 
the UDC. Thus, if a system were configured with four hard disks on a 
UDC and four floppy disks on an FDC, the device address of the hard 
disk would be $FF0000 and that of the floppy would be $FF0200. The 
device mnemonics would be HDOO, HDOl, HD02, HD03, FDIO, FDll, FD12, 
and FD13. If all disk drives were configured on a UDC, the device 
address would be $FFOOOO, and the device mnemonics would be HDOO, 
HDOl, HD02, HD03, FD04, FD05, FD05, and FD07. Floppy disk drives 
configured on a VM22 IPC begin with a device number of 8, regardless 
of the number of hard disk drives also configured on the VM22 IPC. 
Thus, if a system were configured with four hard disks and four floppy 
disks on a VM22 IPC, the device address would be $FFOOOO, and the 
device mnemonics would be HDOO, HDOl, HD02, HD03, FD08, FD09, FDOA and 
FDOB. 

The device address of the first MVME315 is assumed to be $FFOOOO. 
Each subsequent MVME315 has an address of $200 bytes greater than the 
previous. 

The device mnemonics for disk drives are determined as follows: 

1. The first two characters are: 

HD (if hard disk). 
FD (if floppy disk). 
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g. The device addresses of RWINl and MVME420 are determined by jumper 
selection on board. 

The device mnemonics for disk drives configured on the RWINl and 
MVME420 are determined as follows: 

1. The first two characters are: 

HD (if hard disk). 
FD (if floppy disk). 

2. The third character indicates the controller type. 

3. The fourth character indicates the device number. 

Hard disks always begin with a device number of 0, and floppy disks 
always begin with a device number of 2. Thus, if a system were 
configured with two hard disks and two floppy disks on a RWINl, and 
one hard disk and two floppy disks on a MVME420, the device mnemonics 
would be HDOO, HDOl, FD02, FD03, HD20, and FD22. 

h. The device address of MVME435A is determined by jumper selection on 
the board. 

The device mnemonics for tape drives are determined as follows: 

1. The first two characters are MT. 

2. The third character indicates the board number (0, 1, 2, ...). 

3. The fourth character indicates the device number on that board 
(0, 1, 2, 3, 4, 5, 6, 7) (see following figure). 
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MVMEllO 
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B.2 DEFINITION OF DCBs AND CDBs 

To modify the standard device configuration, an understanding of the DCBs' and 
CDBs' formats is necessary. Macros in the files MACRO.*.* have been defined 
to build the DCBs and CDBs. The DCBs are built using macros that contain 
device-independent data followed by the device-dependent data. The macro 
defining the device-independent data is common to all DCBs. The CDB macro 
defines a channel data block that is used to allocate channels. 

The information required by the macro to build the appropriate DCB or CDB is: 

DIPDCB MACRO This macro defines the device-independent portion of a DCB and 
is used by the disk macro DSKDCB, the terminal macro CRTDCB, 
the mag tape macro MTADCB, and the printer macro PRTDCB. 

PARAMETER LENGTH 
NUMBER IN BYTES DESCRIPTION 

\1 4 This parameter is set to the length of the DCB being 
generated. It is used to build the address of the next 
DCB in the linked list. The DCB length is represented 
respectively by the equate CDCBLN, DDCBLN, PDCBLN for 
the terminal, disk, and printer. A value of zero 
implies the end of the linked list. 

\2 4 This field contains the device mnemonic for this DCB 
(ASCII). 

\3 4 This field contains the taskname of the driver to which 
this DCB belongs. 

\4 4 This field contains the session number of the driver to 
which this DCB belongs. 

\5 2 This field contains attributes of the device associated 
with this DCB. 



BIT 


ATTRIBUTE 





Supports Read 


1 


Supports Write 


2 


Supports Binary 


3 


Supports Random 


4 


Supports Image 


5 


Supports Halt- I/O 


6 


Supports Position R 


7 


Supports Filemark 


8 


Interactive Device 


9 


Printer Device 


10 


Supports Spooling 


11 


Supports Write with 




Redundancy Check (C 


12-15 


Reserved 



Record 



Cyclic 
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PARAMETER 
NUMBER 

\6 



LENGTH 
IN BYTES 



\7 



DESCRIPTION 

This field contains a decimal code identifying the type 
of device and is maintained for backward compatibility 
only. 

Device 

Interactive terminal on IPC interface 

(Motorola EXORterm 155 or VME/10) 
Interactive terminal on IPC interface 

(Non-EXORterm 155 or non-VME/10) 
Interactive terminal on local driver 

(Motorola EXORterm 155 or VME/10) 
Interactive terminal on local driver 

(Non-EXORterm 155 or non-VME/10) 
Magnetic tape 

Low speed line printer on IPC 
High speed line printer on IPC 
Low speed line printer on local driver 

To get information about a device, do a CONFIGURE/STATUS 
REQUEST (TRAP #2), which returns a channel type code 
field in the configuration status block. The device 
type code field displays whether the device is a 
terminal, printer, tape, floppy disk, or hard disk. 

The attributes word and parameters provide detailed 
information about the device configuration. Refer to 
the VERSAdos Data Management Services and Program Loader 
User's Manual for more information. 

This field contains the current device status. 



Hex 
$1E 


Code 
30 


$1F 


31 


$23 


35 


$24 


35 


$3C 
$5A 
$5B 
$5F 


60 
90 
91 
95 



a 



\8 
\9 
\A 



BIT MEANING 

--> Device offline 
1 --> Device online 

1 --> Device not write protected 
1 --> Device write protected 

2 1 --> Device status has changed 

3 1 --> Device busy for initialization 

4 1 --> Device busy for configuration. 

5 --> No timer to be cancelled for this device. 
1 --> Timer to be cancelled for this device. 

6 1 --> Ignore timer event for this device. 



This field contains the ASCII channel 
associated with this DCB. 



identifier 



This field contains the device number associated with 
the channel for this DCB. 

Address of supervisor DCB or session number if this is 
a supervisor DCB (for MVME300 GPIB drivers only). 
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CRTDCB MACRO 



This macro defines the DCS for a terminal. 



PARAMETER 
NUMBER 



DIPDCB 

\9 

\A 

\B 

\C 
\D 
\E 

\F 

\G 
\H 
\I 

\J 

\K 

\L 

\M 

\N 

\0 



LENGTH 
IN BYTES 



DESCRIPTION 

Define the device- independent portion of the DCB. 

CDCBLN,\1A2,\3,\4,\5,\6,\7,\8,0 (Calls DIPDCB macro 
with these ten arguments, \1 through \A.) 

This field contains the attributes mask for the device 
configuration. 

This field contains the parameters mask for the device 
configuration. 

This field contains the attributes word for the device 
configuration. 

This field contains the number of characters per line. 

This field contains the number of lines per page. 

This field contains the write time-out value for this 
device {0=no time-out). 

This field contains the read time-out value for this 
device (0=no time-out). 

This field contains the value for the XOFF character. 

This field contains the value for the XON character. 

This field contains the value for the BREAK equivalent 
character. 

This field contains the value for the discard output 
character. 

This field contains the value for the reprint line 
character. 

This field contains the value for the cancel line 
character. 

This field contains the read I/O terminators for this 
device. 

This field contains the end-of-line string for this 
device. 

This field contains the baud rate code for this device. 
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PARAMETER 
NUMBER 

\P 
\Q 
\R 



LENGTH 
IN BYTES 

1 
1 
1 



DESCRIPTION 

This field contains the number of NUL characters to use 
for padding. 

This field contains parameters to terminate read I/Os 
for a class of characters. 

This field contains the terminal type code. 

Code Terminal Type 

EXORterm 155, direct connect. 

$1-$7F Reserved for future use. Use a value in this 
range for non-EXORterm 155 or modem. 



Q 



DSKDCB MACRO 


PARAMETER 
NUMBER 


LENGTH 
IN BYTES 


DIPDCB 




\9 


2 


\A 


2 


\B 


2 


\c 


2 


\D 




\E 




\F 




\G 




\H 





This macro defines the DCB for a disk. 

DESCRIPTION 

Define the device-independent portion of the DCB. 

DDCBLN,\1A2,\3A4,\5,\6,V,\8,0 (Calls DIPDCB macro 
with these ten arguments, \1 through \A.) 

This field contains the attributes mask for the device 
configuration. 

This field contains the parameters mask for the device 
configuration. 

This field contains the attributes word for the device 
configuration. 

This field contains the number of bytes per sector. 

This field will contain the total number of sectors for 
this device. 

This field contains the write time-out value for this 
device (0=no time-out). 

This field contains the read time-out value for this 
device (0=no time-out). 

This field contains the number of sectors per track. 

This field contains the number of heads for this device. 
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PARAMETER LENGTH 



NUMBER 
\I 

\J 
\K 
\L 

\M 

\N 

\0 

\P 

\Q 

\R 

\S 



IN BYTES 
2 



DESCRIPTION 

This field contains the number of tracks for this 
device. 

This field contains the value for the interleave factor. 

This field contains the spiral offset value in sectors. 

This field contains the physical sector size of the 
media. 

This field contains the starting head number for the 
drive. 

This field contains the number of cylinders on the 
drive. 

This field contains the precompensation cylinder number 
for the drive. 

This field contains the physical sectors per track on 
the drive. 

This field contains the stepping rate code of the head 
on the drive. 

This field contains the reduced write current cylinder 
number for the drive. 

This field contains the Error Correction Code (ECC) data 
burst length for the drive. 
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PRTDCB MACRO 



This macro defines the DCB for a printer. 



PARAMETER 
NUMBER 



DIPDCB 



LENGTH 
IN BYTES 



\9 


2 


\A 


2 


\B 


2 


\c 


2 


\D 


4 


\E 


4 


\F 


2 


\G 


1 


\L-\S 





DESCRIPTION 

Define the device- independent portion of the DCB. 

DDCBLN,\1,\2,\3A4,\5,\6,\7,\8,0 (Calls DIPDCB macro 
with these ten arguments, \1 through \A.) 

This field contains the attributes mask for the device 
configuration. 

This field contains the parameters mask for the device 
configuration. 

This field contains the attributes word for the device 
configuration. 

This field contains the number of characters per line. 

This field contains the number of lines per page. 

This field contains the write time-out value for this 
device (0=no time-out). 

This field contains the logical line length. 

This field contains the end-of-line character. 

(Refer to lODM.AG source.) 



Q 
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MTADCB MACRO 



This macro defines the DCB for a magnetic tape drive. 



B 



PARAMETER 
NUMBER 



DIPDCB 



LENGTH 
IN BYTES 



\9 
\A 
\B 



\C 
\D 
\E 
\F 
\G 
\H 
\I 
\0 
\K 
\L 



16 



DESCRIPTION 

Define the device-independent portion of the DCB. 

MDCBLNA1.\2A3A4,\5,\6,VA8,0 (Calls DIPDCB macro 
with these ten arguments, \1 through \A.) 

Space for status fields. 

Attributes mask. 

Parameters mask. 

Attributes word. 

Number of bytes/VERSAdos logical sector (not used). 

Total number of VERSAdos sectors on media {not used). 

Write time-out (system). 

Read time-out (system). 

Requested density for write from loadpoint. 

Number of read tries before error message. 

Number of write tries before erasing. 

Number of erasures before error message. 

Time-out for tape read. 

Time-out for space forward or space reverse. 

Time-out for rewind. 

Time-out for search forward or reverse for filemark. 

16 bytes reserved for future use. 
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CDB MACRO 



This macro defines the channel data block macro inputs 
that are used to build the CCB. 



PARAMETER 
NUMBER 

*+CDBLN 



LENGTH 
IN BYTES 



\1 


4 


\2 


4 


\3 


4 



\4 

\5 

\6 

\7 

\8 

\9 

\A 

\B 

\C 
\D 

\E 



DESCRIPTION 

This field contains the address of the next CDB in the 
linked list. 

This field contains options for the Allocate command. 

This field contains the ASCII channel mnemonic. 

This field contains the channel type (refer to the 
VERSAdos to VME Hardware and Software Configuration 
User's Manual for the table of channel types). 

This field defines the maximum number of consecutive 
commands that can be interpreted with interrupts masked 
during a single I/O call (applies only to byte mode 
(nonlPC) channels). 

This field contains the physical address of the driver 
associated with the CCB to be created from this CDB. 

This field contains the supervisor channel mnemonic and 
is applicable only if bit 3 of the options is set. 

This field contains the physical address of the device 
in memory mapped I/O space. 

This field contains the number of bytes the device 
occupies in memory mapped I/O space. 

This field contains an auto vector (25-31) or a user 
vector (64-255) number. 

This field contains the hardware polling priority in the 
range of 1 to 7. 

This field contains the software priority in the range 
of 0-255, where 255 represents the highest priority. 

This field represents the segment count. 

This field contains the zero relative offset from the 
memory mapped I/O space where the first polling byte 
resides. 

This field is used with the polling test value to 
determine if the device caused the interrupt. 
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PARAMETER 
NUMBER 


LENGTH 
IN BYTES 


\F 


4 


\G 


4 


\H 


4 


\I 


4 


\J 


4 


\K 


4 


\L 


4 


\M 


4 



DESCRIPTION 

This field contains the polling test value. 

This field contains the zero relative offset from the 
base of memory mapped I/O where the reset byte resides. 

This field contains the value to reset, clear the 
interrupt, for the particular device. 

This field contains the zero relative offset from the 
memory mapped I/O space where the second polling byte 
resides. 

Reference E above. 

Reference F above. 

Reference G above. 

Reference H above. 
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B.3 MACRO EXAMPLES 



Terminal DCB Example 



The following 


nput parameters: 




\1 CNIO 


\B TCP$ATW 


\L $18 


\2 lOSID 


\C $50 


\M $DDEOOOO 


\3 lOSESS 


\D $18 


\N $DOAOOOO 


\4 $133 


\E $DBBAO 


\0 $E 


\5 30 


\F $DBBAO 


\P $0 


\6 1 


\G $13 


\Q $0 


\7 CHAN ID 


\H $0 


\R $0 


\8 


\I $3 




\9 $06FE 


\J $F 




\A $5FB3 


\K $1A 






IFGE NTV30$1-1 

CRTDCB 'CN10MOSID,IOSESS,$133,30,1,'CHAN_ID',0,$06FE,$5FB3,TCP$ATW,$50,$18, 
$DBBAO,$DBBAO,$13,$0,$3,$F,$lA,$18,$DDE0O0O,$DOAO0O0,$E,$0,$O,$O 



were used to create the following terminal DCB: 



SECTION 





DIPDCB 


CDCBLN,'CN10 


DC.L 


*+CDCBLN 


DC.L 


'CNIO' 


DC.L 





DC.L 


lOSID 


DC.L 


lOSESS 


DC.L 





DC.L 


$133 


DC.W 





DC.W 





DC.L 





DCB 


30 


DCB 


1 


DC.L 


'CHAN ID' 


DCB 





DCB 





DC.L 





DS.B 


lOSBLN 


DC.L 





DCB 





DCB 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 






— DCB SECTION — 
',I0SID,I0SESS,$133,30,1,'CHAN_ID',0,0 
Address of next DCB in linked list. 
ASCII identification for this DCB. 
Address of Device Connection Queue (DCQ) entry. 
Name of task making the request. 
Session of task making the request. 
Address of LUT. 

Attributes of device associated with this DCB. 
Write/Read protect codes. 
'Device in use' flag. 
Write/Read counts. 
Device flag (device code). 
Device flag (device status). 
Channel identification. 
Device number associated with the channel. 
Task priority. 
Current record number. 

Storage area for the Input/Output Control Block (lOCB) 
being processed. 

Logical address of lOCB in user's address space. 
Configuration coordination flag (0 --> at defaults). 
Break count. 

Address of break service LUT. 
Break service address. 
Event cl aimer -- taskname. 
Event claimer -- session number. 
Address of supervisor DCB or session. 
Supervisor/subordinate DCB open count. 
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Q 



DC.L 


0,0,0,0 


DC.B 


0,0,0,0 


DC.W 


$06FE 


DC.W 


$5FB3 


DC.W 


TCP$ATW 


DC.W 


$50 


DC.L 


$18 


DC.L 


$DBBAO 


DC.L 


$DBBAO 


DC.B 


$13 


DC.B 


$0 


DC.B 


$3 


DC.B 


$F 


DC.B 


$1A 


DC.B 


$18 


DC.L 


$DDE0000 


DC.L 


$D0A0000 


DC.B 


$E 



Device- independent/dependent buffer zone. 

Space for status fields. 

Attributes mask. Attributes mask is logically ANDed 

with the attributes word to yield bits looked at. 

Parameters mask. 

Attributes word. 

Number of characters/line. 

Number of lines/page. 

Write time-out (0=no time-out). 

Read time-out {0=no time-out). 

XOFF character (not applicable to EXORmacs). 

XON character (not applicable to EXORmacs). 

BREAK equivalent character (not applicable to 

EXORmacs). 

Discard output character. 

Reprint line character. 

Cancel line character. 

Read terminators. 

End-of-line string. 

Baud rate code ($E=9600). The following codes may be 

used to indicate the desired baud rate: 



Code 

$00 
$01 
$02 
$03 
$04 
$05 
$06 
$07 
$08 
$09 



Rate 

50 

75 

110 

134. 

150 

300 

600 

1200 

1800 

2000 



Code 



Rate 



$0A 


2400 


$0B 


3600 


$0C 


4800 


$0D 


7200 


$0E 


9600 


$0F 


19200 


$10-FF 


Reserved 



DC.B 
DC.B 
DC.B 
DC.B 

DC.B 
ENDC 



$0 

$0 

$0 

0,0,0,0,0, 

0,0,0,0,0 

0,0,0,0,0,0 



NUL padding. 

Terminator class. 

Terminal type (0=EXORterm 155, j3=any other type), 

Internal use only. 

Reserved. 
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Printer DCB Example 



The following 


nput parameters: 


\1 PRTDV 


\9 $0003 


\2 lOSID 


\A $0023 


\3 lOSESS 


\B PCP$ATW 


\4 $632 


\C $84 


\5 91 


\D $42 


\5 1 


\E $1D4C0 


\7 CHAN ID 


\F $84 


\8 4 


\G $D 




IFGE NPV30$1-1 
SET $0 (PCP$ATW) 

PRTDCB PRTDV,IOSID,IOSESS,$632,91,1,'CHAN_ID',4,$0003,$0023,PCP$ATW,$84, 
$42,$1D4C0,$84,$D 



were used to create the following printer DCB: 



SECTION 





DIPDCB 


PDCBLN, PRTDV, 


DC.L 


*+PDCBLN 


DC.L 


PRTDV 


DC.L 





DC.L 


lOSID 


DC.L 


lOSESS 


DC.L 





DC.L 


$632 


DC.W 





DC.W 





DC.L 





DCB 


91 


DCB 


1 


DC.L 


'CHAN ID' 


DCB 


4 


DCB 





DC.L 





DS.B 


lOSBLN 


DC.L 





DCB 





DCB 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 


0,0,0,0 


DCB 


0,0,0,0 



— DCB SECTION — 
I0SID,I0SESS,$632,91,1,'CHAN_ID',4,0 

Address of next DCB in linked list. 

ASCII identification for this DCB. 

Address of DCQ entry. 

Name of task making the request. 

Session of task making the request. 

Address of LUT. 

Attributes of device associated with this DCB. 

Write/read protect codes. 

'Device in use' flag. 

Write/read counts. 

Device flag (device code). 

Device flag (device status). 

Channel identification. 

Device number associated with the channel. 

Task priority. 

Current record number. 

Storage area for the lOCB being processed. 

Logical address of lOCB in user's address space. 

Configuration coordination flag (0 --> at 

defaults). 

Break count. 

Address of break service LUT. 

Break service address. 

Event cl aimer -- taskname. 

Event claimer -- session number. 

Address of supervisor DCB or session. 

Supervisor/subordinate DCB open count. 

Device independent/dependent buffer zone. 

Space for status fields. 
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DC.W 


$0003 


DC.W 


$0023 


DC.W 


PCP$ATW 


DC.W 


$84 


DC.L 


$42 


DC.L 


$1D4C0 


DC.L 





DC.W 


$84 


DC.B 


$D 


DCB.B 


15,0 


ENDC 





Attributes mask. 
Parameters mask. 
Attributes word. 
Number of characters/line. 
Number of lines/page. 
Write time-out. 
Read time-out. 
Logical line length. 
End-of-line character. 
Reserved space {15 bytes). 
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Disk DCB Example 

The following input parameters: 



\1 DSKNM 
\2 lOSID 
\3 lOSESS 
\4 DEVATT 
\5 DEV_CODE 
\6 DEV_STAT 
\7 CHAN_ID 
\8 DSKNM&$F 
\9 ATT_MASK 
\A PAR_MASK 



\B ATT WORD 


\L OFF 


\C $100 


\M BYTES PER SECTOR 


\D 


\N START HEAD NUM 


\E $0 


\0 CYL DRIVE 


\F $0 


\P PRE COMP 


\G SECT PER TRK 


\Q SECT DRIVE 


\H NUM HEADS 


\R STEP RATE 


\I CYL DISK 


\S R W PRE COMP 


\J INTERLEAVE 


\T ECC LEN 


\K SPIRAL 





Q 



DSKDCB DSKNM, IOSID,IOSESS,DEV_ATT,DEV_CODE,DEV_STAT,CHAN_ID,DSKNM&$F, 
ATT MASK, PAR MASK, ATT_WORD, $100, 0,$0,$0,SECT_PER_TRK,NUM_HEADS, 
CYL~DISK, INTERLEAVE, SPIRAL_OFF,BYTES_PER_SECTOR,START_HEAD_NUM, 
CYL"DRIVE,PRE COMP, SECT DRIVE, STEP_RATE,R_W_PRE_COMP,ECC_LEN 



were used to create the following disk DCB: 



SECTION 





DIPDCB 


DDCBLN, DSKNM, 




DSKNM&$F,0 


DC.L 


*+DDCBLN 


DC.L 


DSKNM 


DC.L 





DC.L 


lOSID 


DC.L 


lOSESS 


DC.L 





DC.L 


DEV ATT 


DC.W 





DC.W 





DC.L 





DCB 


DEV CODE 


DCB 


DEV STAT 


DC.L 


'CHAN ID' 


DCB 


DSKNM&$F 


DCB 





DC.L 





DS.B 


lOSBLN 


DC.L 





DCB 





DCB 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 





DC.L 


0,0,0,0 



— DCB SECTION — 
IOSID,IOSESS,DEV_ATT,DEV_CODE,DEV_STAT,CHAN_ID, 

Address of next DCB in linked list. 

ASCII identification for this DCB. 

Address of DCQ entry. 

Name of task making the request. 

Session of task making the request. 

Address of LUT. 

Attributes of device associated with this DCB. 

Write/Read protect codes. 

'Device in use' flag. 

Write/Read counts. 

Device flag (device code). 

Device flag (device status). 

Channel identification. 

Device number associated with the channel. 

Task priority. 

Current record number. 

Storage area for the lOCB being processed. 

Logical address of lOCB in user's address space. 

Configuration coordination flag (0 --> at defaults). 

Break count. 

Address of break service LUT. 

Break service address. 

Event claimer --taskname. 

Event claimer --session number. 

Address of supervisor DCB or session. 

Supervisor/subordinate DCB open count. 

Device- independent/dependent buffer zone. 
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DC.B 


0,0,0,0 


DC.W 


ATT MASK 


DC.W 


PAR MASK 


DC.W 


ATT WORD 


DC.W 


$100 


DC.L 





DC.L 


$0 


DC.L 


$0 


DC.B 


SECT PER TRK 


DC.B 


NUM HEADS 


DC.W 


CYL DISK 


DC.B 


INTERLEAVE 


DC.B 


SPIRAL OFF 


DC.W 


BYTES PER SECTOR 


DC.W 


START HEAD NUM 


DC.W 


CYL DRIVE 


DC.W 


PRE COMP 


DC.B 


SECT DRIVE 


DC.B 


STEP RATE 


DC.W 


R W PRE COMP 


DC.W 


ECC LEN 


DC.B 


0,0 



Space for status fields. 

Attributes mask. 

Parameters mask. 

Attributes word. 

Number of bytes/sector. 

Total number of sectors -- returned information. 

Write time-out. 

Read time-out. 

Number of sectors/track. 

Number of heads. 

Number of cylinders on media. 

Interleave factor. 

Spiral offset (in sectors). 

Physical sector size of media. 

Starting head number on drive. 

Number of cylinders on drive. 

Precompensation cylinder number. 

Physical sectors per track on drive. 

Stepping rate. 

Reduced write current cylinder number. 

ECC data burst length. 

2 bytes reserved as offset to another parameter 

block. 



ENDC 
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CDB MACRO Example 



The following i 


nput parameters: 




\1 $0000 


\9 VECTNBR 


\H 3 


\2 CNAME 


\A VECTLVL 


\I 


\3 CTYPEl 


\B PRI0RTY2 


\J 


\4 254 


\C 1 


\K 


\5 ACIA 


\D 


\L 


\6 


\E $80 


\M 


\7 LTDA$02 


\F $80 




\8 3 


\G 





Q 



CDB $0000, CNAME, CTYPEl, 254, ACIA, 0,LTDA$02, 3, VECTNBR, VECTLVL, PRI0RTY2, 
1,0, $80, $80, 0,3, 0,0, 0,0,0 



were used to create the following CDB: 



SECTION 


1 


DC.L 


*+CDBLN 


DC.W 


$0000 


DC.L 


CNAME 


DC.B 


CTYPEl 


DC.B 


254 


DC.L 


ACIA 


DC.L 





DC.L 


LTDA$02 


DC.W 


3 


DC.B 


VECTNBR 


DC.B 


VECTLVL 


DC.B 


PRI0RTY2 


DC.B 


1 


DC.W 





DC.B 


$80 


DC.B 


$80 


DC.W 





DC.B 


3 


DC.B 





DC.W 





DC.B 





DC.B 





DC.W 





DC.B 





DC.B 





SET 


DVCODE+1 


ENDC 





— CDB SECTION — 

Pointer to next CDB in list. 

Options for the Allocate command. 

Channel mnemonic. 

Channel type. 

Masked interrupt maximum instruction count. 

Physical address of driver. 

Supervisor channel's mnemonic (only if bit 3 of 

options is set). 

Physical address of device in memory-mapped I/O space. 

Number of bytes device occupies in memory-mapped I/O 

space. 

Vector number. 

Polling priority. 

Software priority. 

Segment count. 

Polling byte offset. -- [#1] -- 

Polling mask. 

Polling test value. 

Offset from physical device address for reset. 

Value for reset. 

Reserved. 

Polling byte offset. -- [#2] -- 

Polling mask. 

Polling test value. 

Offset from physical device address for reset. 

Value for reset. 

Reserved. 
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APPENDIX C 
TYPICAL SYSGEN COMMAND FILES 



Following is a listing of the SYSGEN command source files <system>. SYSTEM. CI, 
<system>.CNFGDRVR.CI, and <system>.IFDRVR.CI, as furnished for a VME/10 system 
with VERSAdos. Furnished SYSGEN files can be edited by the user to change 
parameters to reflect the desired configuration. The VMESIO.CNFGDRVR.CI and 
VMESIO. SYSTEM. CI files are designed to be executed with the chainfile 
&. SYSGEN. CF. SYSGEN is normally invoked from a chainfile. The following 
example is invoked from STD. SYSGEN. CF. Refer to the &. SYSGEN. CF chainfile for 
detailed instructions to invoke the SYSGEN process. 



B 
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♦ VMESIO. SYSTEM. CI 
* 
»*»•»♦»♦♦«♦»»»•»»»»»♦♦»»♦»•»»»»»»»*»♦»♦•»•»•♦••♦»•*»»•»»*•♦»»»♦»♦♦♦•»*«»»»■»» 

• This file contains all board/system dependencies for VME/IO. * 

• It is called from "«c. VERSADOS. CD". * 

♦ * 

* The user should not have to modify this file except under extreme • 
« circumstances. * 



ON BOARD RAM ADDRESSES 

VMEbus drivers require the follouing target system dependent 
variables to be defined when the macro file DUALPORT. MC is used: 
Note that the ONBDtHI parameter may vary on the VMEllO and 
and VMElOl systems depending on the size and number of RAM 
chips used on the processor card. The values shoiun are the 
minimum req.uirements. Modify that parameter to match your oun 
system if different. 



ONBD$LO ^ iO Loui value for on-board ram (as seen by driver > 

ONBD*HI - *5FFFF High value for on-board ram (as seen by driver) 

RAM^SQ = tDOOOOO Difference betueen on-board ram address as seen by 
* driver and device. 

OFFBDILO <= \ONBD*LO-«-\RAM*SQ Lou value for on-board ram (as seen by device) 

OFFBD»HI = VONBD^HI-i'VRAMtSQ High value for on-board ram (as seen by device) 



MSG 
MSG 

Mse 



•* Addresses of timeri etc. 



TIMER 
CLOCKFRQ 
PANEL 
TRCFLA<} 



«FiA08t Address of timer. 

Number of clock ticks per millisecond 

*0 Address of front panel. 

Trace flag. Zero implies don't trace. The 

setting of bits in the TRCFLAG parameter uiill 
control uhich events cause an entry to be built 
in the trace table. 
Bit # in TRCFLAG Event 
15 TRAP «1 

14 I/O interrupt not claimed 

by user task. 
13 Timer interrupt. 

12 User trap (2-15) 

11 Exception 

10 Dispatch 

9 I/O interrupt claimed by 

user task 
8 Return from LOADMMU 

7 Simulated interrupt 

6 SYSFAIL interrupt. 
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SYSFAIL 



= 



Determines uihether or not 
be interrupted when SYSFA 
Some intelligent boards u 
theg experience a failure 
have such boards in the s 
THESE BOARDS HAVE SYSFAIL 
probablti uant SYSFAIL int 
appropriate SYSFAIL handl 
taking a SYSFAIL interrup 
so you mould uant SYSFAIL 

« disable SYSFAIL int 

1 - enable SYSFAIL int 



the operating system mill 
IL is asserted on the bus. 
ill assert SYSFAIL when 

of some kind. If you 
ystem. AND THE DRIVERS FOR 

HANDLERS, then you mill 
errupts enabled. If the 
ers are not written, then 
t will hang up the system. 

interrupts disabled, 
errupts. 
errupts. 



B 



MSG 
MSG 
MSG 
MSG 
MSG 



»»»»♦♦♦»»»♦»•♦♦»»»•*»»♦•♦••«•»«»»♦•»•**»•*»»••♦**«*•»»•**•»•♦••*** 
«• Local terminal/printer device addresses 
*« Short I/O space base address 
** Short I/O space address offsets 
»»♦•»*•»»♦»♦»•♦♦»»»»•»•*»♦•••»*»»»♦♦♦«»••»»»»*♦•♦•»♦**♦»»»*»•*•♦*• 



KBDOVRD 



= O 



Keyboard override option: 

= keyswitch on front panel is enabled 

1 = keyswitch override - if key is in locked 

position the keyboard is still enabled. 
NOTE: This parameter is only valid with VME/10 
units with the panel keyswitch. 



SIOBASE 
INCLUDE 



$FFOOOO Base address of Short I/O space 

S 10. ADDRESS. CI get short I/O space addresses offsets 



MSG 
MSG 
MSG 
MSG 



♦♦»»*♦•*»»»»»*«»♦»♦♦»»♦♦»♦«»»»♦♦»*»♦*»•♦*»*•»»*»»♦♦*•••»*♦****•*** 
«* I/O Channel is on this CPU board. 
♦*«»»»•»»»♦♦•»»*»•*•»»»»»•♦»♦♦♦»»»»»*♦♦♦♦•♦•»»»»»•♦»*♦*»*••**♦**•* 



CMULT 

» 
« 

« 



I/O channel multiplier (see IOC. ADDRESS. CI ) : 
= 1 for IOC run directly on the MC68020 or 

MC68008 address bus of a user's custom CPU 
board (because of byte addressing) 
' 2 for all others where byte address is not 
available (only odd addresses are used) or 
if running the IOC from a VME316 board 



&IOCBASE 
INCLUDE 



*F1C000 Base address of I/O channel 

IOC. ADDRESS. CI get I/O channel addresses offsets 



»» Vector numbers •* 

» 

I/O channel interrupt 1 vector. 
I/O channel interrupt 



lOCVECl 


= 


«41 


I0CVEC2 


= 


•43 


I0CVEC3 


= 


S44 


I0CVEC4 


K 


*45 


lOCLVLl 


s 


2 


I0CLVL2 


= 


4 


I0CLVL3 


3= 


5 



I/O channel interrupt 

I/O channel interrupt 

I/O channel interrupt 

I/O channel interrupt 

I/O channel interrupt 



vector, 
vector, 
vector. 

level, 
level, 
level. 



73 



MICROSYSTEMS 



® 



MOTOROLA 



APPENDIX C 



a 



I0CLVL4 


= 6 


MSG 


*« 


MSG 


»♦ 


MSG 


»» 


TIMSLIC 


= 2 


TIMINTV 


= lb 



MEMENDl 

MEMEND2 

» 

MEMEND3 

WHERLOAD 

» 

CACHEF 
NOTNT 

MSG 
MSG 
MSG 

PAGESIZE 

ASN 

MSG 
MSG 
MSG 
MSG 
MSG 

=COPY 



I/O channel interrupt 4 level. 

•»♦»»•»»»»»»»»•♦»»♦♦»»»»»•♦•♦♦*»»•♦♦»«*•»«»♦»»»*♦*»»*»»»»»»»»»»»♦* 

Descriptive info about this operating system 
»»♦»♦♦♦»»*»»»♦»»»»»»»•»»»»»«»»»»»•♦»»«»»♦»»••»»»»»»*»»»»»♦*»»♦*»»* 



ROMEADDR = *0 



*2FF00 
*2FF00 

4280000 



Number of timer interrup 
Number of milliseconds b 
(Not used on VME/10. It 
onli). The actual value 
15. 625 msec. ) 
ROM end address — defin 
system. Set to $0 i 
The ROM start addres 
in the <si)stem>. RMS 
to the initial progr 
Ending addr for on-board 
Starting addr for off-b 
be >= this. Not applic 
Ceiling addr for off-boa 
Memory address inhere boo 
Nonzero on VMOl only. I 
be moved at initializati 
Not used by VMESIO (need 
Not used by VMESIO (need 



ts per time slice, 
etueen timer interrupts. 

is included for documentation 
used for the VME/IO is 

ed by user for a ROMmable 

f not a ROMable system. 

s (ROMSADDR) is defined 

CI file and has a value equal 

am counter. 

memory must be < this, 
oard memory must 
ble for a VMEllO 
rd memory (must be < this), 
t file mill be loaded 
f nonzeroi VERSAdos mill 
on time. 

ed by 8<. INITDAT. AG) 
ed by EET. VERSADOS. CI ) 



»♦»»*•»»»»*♦»♦**♦»»♦»»»»»♦»•♦*♦♦»*•»»•»»»»*»♦»**«»»»♦•*»»*•*•«»»• 
** Parameters about table sizes< etc. 
♦»»♦»»»»»♦••»♦*»•»♦»»»»»*•*»»»»•*•*»♦♦»♦»•*•♦*»»»*»»♦»*•♦»♦»**•** 



256 
127 



Size in bytes of a page of memory. 
# of address spaces 



»»»»»»»♦»»»»»»»»♦»*»♦♦♦»*♦»»♦»»»»»»»♦«♦»•»«»*♦♦»♦••»•«*»*»•»»**»•»* 

» Copy C80C.SYSPAR.ro into «<. SYSPAR. RO to make it generic 

» for . UG files and possible for sysgening more than 1 system 

• per account # 

»»»»♦•»*»»*•*•«•♦«»•»•***»*«♦♦»»»»«•♦♦»*»*♦»*»*»»*»»«•*«»»****♦***» 

CAGE. SYSPAR. RO. fc. SYSPAR. ROi Y 
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VMESIO. CNFGDRVR. CI 
Configuration file for device drivers 



» This file sets up the flags used by the "VMESIO. IFDRVR. CI" file to 

» conditionalli) include device drivers. 

« 

» The user should only have to modify this file to include/exclude drivers. 

» If you add more boards/devices, you may have to increase the sysgen 

» command T option for more symbols in the "&. SYSOEN. CF" file. 

* 

» To modify specific items of a driver, edit the corresponding driver file, 

» "ifc. xxxxDRV. CI" except as noted inhere one driver handles multiple boards. 

■» 

»,»»»»»»»♦»»»»»»*♦*♦»»»»»»♦♦»»♦♦»»♦♦♦♦»»♦»♦»♦»»♦•»♦»♦»♦•»*•»♦•»»*•**»»«»»♦«»•* 

» BOARD/SYSTEM DEPENDENCIES are included from the «t. VERSADOS. CD file. 

» VMESIO. SYSTEM. CI add processor board/system dependencies. 
» including local terminals and printers 

» 8-. CNFGTASK. CI add 0/S task configuration for ROM/RAM 




NOLTERM 



# of terminals on VMESIO serial ports (TERM); max= 1 



•» 

NORWIN 

IFGT 

CONTWINl 

NHRUIN«1 

NFRWIN*! 

RWIN0*1 

RWIN1«1 

RWIN2«1 

RUIN3!»1 

C0NTWIN2 

NHRWINS2 

NFRUIN«2 

RWIN0*2 

RMIN1«2 

RUIN2«2 

RUIN3«2 



# of RWINl 



Winchester controller boards 



\NORWrN 

_ l.QU 

= 1 

= 1 

= "'H5WIN15' 

= "'H5WIN15' 

= " 'F5DDDSI ' 

= " 'F5DDDSI ' 

"1" 



O 

" 'H5WIN15' 

" 'H5WIN15' 

" 'F5DDDSI ' 

" 'F5DDDSI ' 



1st RWINl is controller 

» of hard disk drives on 1st RWINl; max= 2 

# of floppy disk drives on 1st RWINl; max- 2 
Type of 1st hard disk on 1st RWINl. drive 
Type of 2nd hard disk on 1st RWINl. drive 1 
Type of 1st floppy disk on 1st RWINl. drive 2 
Type of 2nd floppy disk on 1st RWINl. drive 3 

2nd RWINl is controller 1 

# of hard disk drives on 2nd RWINl; max= 2 
» of floppy disk drives on 2nd RWINl; max= 2 
Type of 1st hard disk on 2nd RWINl. drive 
Type of 2nd hard disk on 2nd RWINl, drive 1 
Type of 1st floppy disk on 2nd RWINl, drive 2 
Type of 2nd floppy disk on 2nd RWINl, drive 3 



NOTE: 



You can not mix 5-1/4" and 8" floppies. Pick one or the other. 



ENDC 



NVME050 





IFGT 


\NVME050 


NT050*1 


= 


NP050*1 


= 


ENDC 





« of VME050 System Controller 

» of terminals on the VME050 board; max- 2 
# of printers on the VME050 board; max= 1 
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NVME300 



= O 



« of MVt1E300 IEEE 488 OPIB controller boards 



B 



» 

IMVME315 = O 

IFOT \NVME315 
C0NT3151 = "3" 
NH315*1 » 
NF315*1 = 



# of MVME315 ttiinchester/f loppy disk controller boards 

1st MVME315 is controller 3 

tt of hard disk drives on 1st VME315i inax= 2 

# of floppy disk drives on 1st VME315i aiart= 4 



M3 150*1 
M315l*l 
M3I54»1 
M3155«l 
M3 156*1 
M3 157*1 

C0NT3152 

NH315*2 

NF315*2 

113 150*2 
M3151*2 
M3 154*2 
M3 155*2 
M3 156*2 
M3 157*2 
ENDC 



"H5UINi5"' Type of 1st hard disk on 1st MVME315 board 

'H5WIN15'" Type of 2nd hard disk on 1st MVME315 board 

'F8SDDSM'" Type of 1st floppy disk on 1st MVME315 board 

'F8SDDSM'" Type of 2nd floppy disk on 1st MVME315 board 

'F5DDDSI'" Type of 3rd floppy disk on 1st MVME3i5 board 

'F5DDDSI'" Type of 4th floppy disk on 1st MVME315 board 



II ^« 




'"H5WIN15' 
"'H5WIN15' 
"'F8SDDSM' 
■"F8SDDSM' 
" 'F5DDDSI ' 
" 'F5DDDSI ' 



2nd MVME315 is controller 4 

# of hard disk drives on 2nd VME31Si max= 2 

tt of floppy disk drives on 2nd VME31Si mat" 4 

Type of 1st hard disk on 2nd MVME315 board 

Type of 2nd hard disk on 2nd MVME315 board 

Type of 1st floppy disk on 2nd MVME315 board 

Type of 2nd floppy disk on 2nd MV/ME315 board 

Type of 3rd floppy disk on 2nd MVME315 board 

Type of 4th floppy disk on 2nd MV/ME315 board 



NVME316 =0 # of liVME316 VMEbus to I/O channel interface boards. 

• ma X ' 1 

»»•» NOTE: Do not use VME316 in this system, as I/O channel is already on 
«««« the CPU board! See "«<. DRV316. CI" for details. 



NVME320 = 

IFOT \NVME320 
C0NT320 = "2" 
NH320*1 = O 
NF320*1 = 



M3200*l 
M3201*l 
M3202*l 
(«13203*1 
ENDC 



» of MVME320 Winchester/floppy controller boards 

MVME320 is controller 2 

» of hard disk drives on VME320i max= 2 

* of floppy disk drives on VME320< max= 2 



■"H5WIN15'" Type of 1st hard disk on 1st MVME320 board 

■"H5WIN15'" Type of 2nd hard disk on 1st MVnE320 board 

"'F5DDDSI'" Type of 1st floppy disk on 1st MVME320 board 

■"FSDDDSI"' Type of 2nd floppy disk on 1st MVME320 board 



NVME400 = 1 

IFOT \NVME400 
NU400*1 = 2 
NU400«2 = 

ENDC 



* of MVHE400 dual 7201 serial port boards 

tt of ports/users on VME400 bd. ttli max^ 2/bd. 
tt of ports/users on VME400 bd. tt2i max« 2/bd. 



NVME410 



tt of MVME410 dual 16-bit parallel port boards 
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IFGT \NVME410 

NU410*1 =1 « of printers in use on VME410 board #1; iiiax= 2 

NU410*2 =0 # of printers in use on VME410 board #2; (nax= 2 

ENDC 

» 

NVME435 =0 « of MVME435 mag tape controller boards; ma«= 2 

IFGT \NVME435 

N435*l =0 # of tape drives on first MVME435 boardi max- 8 

N435*2 =0 # of tape drives on second MVME435 boardi max= 8 

ENDC 

» 

NVME600 =0 # of MVME600 analog input controller boards 

•» 

NVME605 =0 # of MVME605 analog output controller boards 

IFGT \NVME605 

NU605 = Number of users (total) for the MVME605 boards 

ENDC 

» 

NVME&IO =0 # of MVME610 AC input controller boards 

IFGT \NVME610 

M610QSIZ = 128 Minimum number of entries in Interrupt Processing Queue 
ENDC 

» 

NVME615 =0 # of MVME615/616 AC output controller boards 

IFGT \NVME615 

NU615 = Number of users (total) for the MVME615 boards 

ENDC 

» 

NVME620 =0 » of MVME620 DC input controller boards 

» 

NVME625 =0 # of MVME625 DC output controller boards 

IFGT \NVME625 

NU625 = Number of users (total) for the MVME625 boards 

ENDC 

» 

NRAD =0 # of RAD Remote A/D boards 

IFGT \NRAD 

NURAD =0 » of RAD users 

ENDC 

» 

NRIO =0 # of RIO Remote I/O boards 

IFGT \NRIO 

NRIOINT =0 # of interrupt levels per I/O module 

ENDC 



B 
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* VMESIO. IFDRVR. CI 
* 

* Conditional file for VMESIO device drivers 



* This file uses flags setup in the VMESIO. CNFCDRVR. CI and VMESIO. SYSTEM. CI 

* files to conditionally include device drivers. 
* 

« The user should not have to modify this file to include/exclude drivers. 

« 

« »•*♦•»*«••»••«*••«♦»»♦♦•♦♦»•••♦•«*♦•»••♦•*»•*♦•»•»•••••••»••«♦••*« 

» ♦* NOTICE: The follouing conditionals are order dependent. •* 

♦ »• Do not change the order! Local drivers 1st. •* 

• «» The order determines device number (HDOOiPRi etc) «* 
« ** for most items. *• 
« ««♦•«♦«»«••««»«♦»♦*»••«*»•«»»»«•«••»•♦•«»»••••«•«•»♦««•*•«•**»«•*• 
« 

« 

IFNE \NVME3i6 

« The VME316 has no driver. It has an initialization module that is 

» merged into SYSINIT. RO. The include file belou defines the I/O channel. 

« 



INCLUDE 


&. M3i6DEF 


CI 


ENDC 






« 






IFNE 


\NORWIN 




INCLUDE 


&. RUINDRV. 


CI 


ENDC 






« 






IFNE 


\NVME320 




INCLUDE 


«.. M320DRV. 


CI 


ENDC 






♦ 






IFNE 


\NVME315 




INCLUDE 


fc. M315DRV. 


CI 


ENDC 






» 






IFNE 


\NOLTERM 




INCLUDE 


DRVSIO. CI 




ENDC 






« 






IFNE 


\NVME400 




INCLUDE 


«c. MPSC400. 


CI 


ENDC 






» 






IFNE 


\NVME410 




INCLUDE 


fc. PIA410. CI 


ENDC 






» 






IFNE 


V.NVME050 




INCLUDE 


«i. MOSODRV 


CI 


ENDC 






« 






IFNE 


\NVME300 




INCLUDE 


«c. M300DRV. 


CI 


ENDC 
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IFNE 


\NVME435 


INCLUDE 


&. M435DRV. CI 


ENDC 




* 




IFNE 


\NVME600 


INCLUDE 


8<. M600DRV. CI 


ENDC 




♦ 




IFNE 


\NVME605 


INCLUDE 


&. M605DRV, CI 


ENDC 




* 




IFNE 


\NVME610+\NVME620 


INCLUDE 


«... M6iODRV. CI 


ENDC 




• 




IFNE 


\NVME615 


INCLUDE 


fc. H615DRV. CI 


ENDC 




* 




IFNE 


\NVME635 


INCLUDE 


&. M625DRV. CI 


ENDC 




» 




IFNE 


\NRAD 


INCLUDE 


&. RADDRV. CI 


ENDC 




* 




IFNE 


\NRIO 


INCLUDE 


«.. RIODRV. CI 


ENDC 
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APPENDIX D 
DEFINITION OF SYSGEN PARAMETERS 



This appendix contains an alphabetical listing of the SYSGEN parameters and 
their definitions. A copy is also on the released media under filename 
O.&.SYSGEN.NW (& = null catalog) for online help capability using the CRT Text 
Editor. 



D E F I N I r I N 



F 



SYSGEN 



PARAMETERS 



Parameter 



De-f inition 



^ADDRESS 

&CRTDV 

'yDEFVOL 

«(DEVADD 
giDSKDV 

&FILENAM 

SiIOCBASE 

«<M4200 

8.M4201 

«!M4202 

?yM4203 

«..M420FLe 

MiPSCFLG 

l!<NF420 
&NH420 
itPCDRV 

&PIAFLAG 



Address of VME420 board 

Starting CRT Terminal Device Code 

The number of default volumes for the system. Minimum is 
4 (See NODEFVOL) 

Starting address of boards on Short I/O address space 

Starting Disk Device Code 

(1 less that ^0_) 

<gets built into HDOO. HDOI, . . . , FD14, FD15, . . . ) 

Parameter used to pass a .AG file a filename to include 
for the assembly. 

Base address of I/O Channel 

Tgpe of disk on drive of VME420 board 

Type of disk on drive 1 of VME420 board 

Type of disk on drive 2 of VME420 board 

Type of disk on drive 3 of VME420 board 

Flag used to Include M420DRV. RO 

If zero then M420DRV has not been included 

If non-zero then M420DRV has already been included 

Flag used to include MPSCDRV. RO 

If zero then MPSCDRV has not been included 

If non-zero then MPSCDRV has already been included 

The number of floppy disks on the VME420 board. 

The number of hard disks on the VME420 board. 

The number of Process Control Drivers 

This redefinable parameter is built as Process Control 

Drivers are included. (VME6xx. RAD. RIO) 

Flag used to include PIADRV. RO 

If zero then PIADRV has not been included 

If non-zero then PIADRV has already been included 
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&PRTDV 
)i<SDRVADD 

8.SDRVR 
&SERFLAG 



&SPRFLAG 

fcSUPFLAG 

fy.T 
&.TOTDSK 

«<TOTPRT 
MOTTERM 

«<VECTNO 

AC I ADR V 

ASMLS 

ASMLSW 

ASN 
AUTOLOGN 



Starting Printer Device Code 

Address of the supervisor driver for MPSC 

Name of the supervisor driver for MPSC 

Flag used to define the number of serial port drivers 
This flag is used to determine if uie need to have 
DRVLIB «< TERMUB. 

If lero then DRVLIB & TERMLIB do not need to be included 
If non-zero then DRVLIB «< TERMLIB do need to be included 

Flag used to include MPSCSPR. RO 

If zero then MPSCSPR has not been included 

If non-zero then MPSCSPR has already been Included 

Flag used to include MPSCSUP. RO 

If zero then MPSCSUP has not been included 

If non-zero then MPSCSUP has already been included 

Temporary parameter used to hold the value to determine 
iiihether the cache uill be flushed or not. 

Total number of disks (floppy & hard) 
This redefinable parameter is built as disks are 
included. Each volume defined requires approximately 
2. 2S bytes of memory. 

Total number of printers 

This redefinable parameter is built as printers are 

included. 

Total number of terminals 

This redefinable parameter is built as terminals are 

included. 

Beginning vector number for boards that are on the Short 
I/O address space. 

Address of the ACIA driver 

ASM listing uork file/device 

Assembly listing file suiitch 

' ASMLS is a file 

1 = ASMLS is a device 

The number of address spaces 

Auto break/logon flag 
Bit 0: 

= Auto break inactive 

1 » Auto break active 
Bit I: 

= Auto logon inactive 

1 = Auto logon active 



AUTOTERM 
BATCHPGE 



Terminal ID of device autologon is to occur on. 
Number of pages for batch job queueing. Each page 
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BATDLY 

BCLRV 

CACHE020 

CACHEF 

CACHESD 

CACHESI 

CACHEUD 

CACHEUI 

CHAINBAT 

CLOCKFRQ 
CMULT 



CONBATCH 

C0NT3151 
C0NT3152 
C0NT320 



accomodates 33 entries. In addition, there is space 
for 31 entries minus the number o* terminals in the 
system. 

Delay in milliseconds in batch betueen reload attempts 
Bus Clear vector number 

Determines whether the 68020's on-chip instruction cache 
mill be used. 

= don't use it 

1 • use it 

Variable for flushing cache 
»F80006 » flush bank 
Dummy value = don't flush bank 

Cache supervisor data accesses 

" don't cache it 

1 • cache it 

Cache supervisor instruction access 

• don't cache it 

1 °: cache it 

Cache user data accesses 

= don't cache it 

1 s cache it 

Cache user instruction access 

^ don't cache it 

1 " cache it 

Suiitcti to indicate if chain and batch processing are 
supported. Value of zero excludes batch and chain; 
non-iero includes them. This package requires approximately 
3-1/2K of memory. 

Number of clock ticks per millisecond 

I/O Channel multiplier 

1 = for IOC run directly on the liC68020 or I1C68008 address 

bus of a user's custom board (because of byte 
addressing ) 

2 = for all others where byte address is not available 

(only odd addresses are used) or if running the IOC 
from a VNE316 board. 

Number of concurrent batch jobs that can be running. 
Cannot be more than NOTASKS. 

Controller number for the 1st VME319 board 

Controller number for the 2nd VME31S board 

Controller number for the VME320 board 



D 
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C0NT4205 

C0NT4208 

CONTWINl 

C0NTWIN2 

DARTDRV 

DARTSPR 

DCP«RTO 

DCP*VSS 

DCPtWTO 

DCQPGE 



DEFAULT 
DEFDAT 



DEFFAB 

DPRVAO 

DRVL 

EET* 

EETSTR 
EPCIDRV 
FAIL 
FHS*IOS» 

FHSASR 
FHSSTR 



Controller number for the SASI 5 board 

Controller number for the SASI 8 board 

Controller number for the 1st RUIN board 

Controller number for the 2nd RUIN board 

Address of DART driver 

Address of supervisor DART driver 

Read timeout for disks 

VERSAdos sector size in bytes 

Urite timeout for disks 

The number of pages of memory for the device connection 
queue (DCQ). Minimum of 1 page> maximum of 10 pages. 
The DCQ is used to save concurrent requests to the same 
file or device. Each page of the DCQ can accomodate 
approximately 9 entries. 

System default volume: usernumber. catalog 

Default Data block length in sectors (256 bytes per sector). 
Used by file handler when no data block size is given at 
file allocation time. Minimum size is 4. Maximum size is 
255. 

Default File Allocation Block (FAB) length is sectors 
(256 bytes per sector). Used by file handler uthen no FAB 
size is given. Minimum size is 1. Maximum size is 20. 

Dual ported RAM offset 

Address of DRVLIB 

Flag to include EET module 

' don't include EET module 

1 = include EET module 

Address of EET 

Address of EPCI driver 

Board fail interrupt vector number 

Flag to include FHS/IOS module 

= don't include FHS/IOS module 

1 = include FHS/IOS module 

FHS ASR entry point 
Address of FHS 
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FMS» Flag to include FMS module 

= don't include FMS module 

1 = include FMS module 

FMSASR FMS ASR entry point 

FMSSTR Address of FMS 

FOUR Starting disk number in ASCII for drive 4 

GOA«UCL Bus O dcv A UCL 

GOB*UCL Bus dev B UCL 

GOC*UCL Bus dev C UCL 

GOD»UCL Bus O dev D UCL 

GOE*UCL Bus dev E UCL 

GOF*UCL Bus dev F UCL 

G06«UCL Bus dev 6 UCL 

GOH*UCL Bus dev H UCL 

GOI*UCL Bus dev I UCL 

GOJ*UCL Bus dev J UCL 

GOK*UCL Bus dev K UCL 

GOLtUCL Bus dev L UCL 

G0M4UCL Bus dev M UCL 

GON*UCL Bus O dev N UCL 

G1A*UCL Bus 1 dev A UCL 

G1B*UCL Bus 1 dev B UCL 

G1C»UCL Bus 1 dev C UCL 

G1D*UCL Bus 1 dev D UCL 

G1E«UCL Bus 1 dev E UCL 

G1F»UCL Bus 1 dev F UCL 

61G*UCL Bus 1 dev G UCL 

G1H*UCL Bus 1 dev H UCL 

GlItUCL Bus 1 dev I UCL 

G1J*UCL Bus 1 dev J UCL 
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G1K*UCL 
G1L»UCL 
G1M*UCL 
G1N»UCL 
GBO»UCL 
6B1»UCL 
GST 

HOGMODE 



INTSTR 

IOC BASE 

IQCLVLl 

I0CLVL3 

I0CLVL3 

iaCLVL4 

lOCM 

IQCSTR 

lOCVECl 

I0CVEC2 

I0CVEC3 

I0CVEC4 

lOSASR 

lOSSTR 

lOV 



Bus 1 dev K UCL 

Bus 1 dev L UCL 

Bus 1 dev M UCL 

Bus 1 dev N UCL 

Bus O User Configuration Length <UCL> 

Bus 1 User Configuration Length (UCL> 

The number of pages in global segment table. Minimum of 
1< maximum of 10. Each page can accomodate approximately 
14 entries. 

Specifies whether or not you want the VM02 to hog the 
VERSAbus (uhich allouis it to run faster when accessing the 
VERSAbus). This may ONLY be used if there are no other 
cards in the system capable of becoming bus master. If in 
doubti use 0. 

= don't hog the bus 

1 = hog the bus (no other intelligent board, i 

Address of the initializer 
I/O Channel base address 
I/O Channel interrupt 1 level 
I/O Channel interrupt 2 level 
I/O Channel interrupt 3 level 
I/O Channel interrupt 4 level 



I/O Channel interrupt 1 vector 

I/O Channel interrupt 2 vector 

I/O Channel interrupt 3 vector 

I/O Channel interrupt 4 vector 

lOS ASR entry point 

Address of lOS module 

The number of pages in the I/O vector table. Minimum of 
1. Each page can accomodate approximately 12 entries. 
For each vector claimed by a task using the CISR directive 
(Configure Interrupt Service Routine) a separate entry is 
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IPCDRV 
KBDOVRD 



KILVECT 
L050*01 
L300»01 
L300»02 
L315»0I 
L315«02 
L320*01 
L320*02 
L33IS01 
L331»02 
L331*03 
L331*04 
L331*05 
L331*06 
L333401 
L333*02 
L333»03 
L333*04 
L333*05 
L333«06 
L400*01 
L400»02 



made into this table. The system imposes no maximum size 
for this parameter. For efficient use of system space> 
however, the formula for computing the table size should 
be: 1+(C/12> uihere 'C ' is the number of different vectors 
that the user expects to claim via CISR directive. 

Address of IPC driver 

Keyboard override flag 

= keysuitch on front panel is enabled 

1 = keysuitch override - if key is in locked position 

the keyboard is still enabled. 

Vector number uihich forces system crash 

Address of 1st VME050 board 

Address of ist VME300 board 

Address of 2nd VME300 board 

Address of 1st VME315 board 

Address of 2nd VME315 board 

Address of 1st VME320 board 

Address of 2nd VME320 board 

Address of ist VME331 board 

Address of 2nd VME331 board 

Address of 3rd VME331 board 

Address of 4th VME331 board 

Address of 5th VME331 board 

Address of 6th VME331 board 

Address of 1st VME333 board 

Address of 2nd VME333 board 

Address of 3rd VME333 board 

Address of 4th VME333 board 

Address of 5th VME333 board 

Address of 6th VME333 board 

Address of 1st VME400 board 

Address of 2nd VME400 board 
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L410*01 

L410»02 

L420*01 

L420*02 

L435*01 

L435*02 

L600*01 

L600*02 

L605t01 

U6 10*01 

L6 10*02 

L6 15*01 

L625*01 

LDR* 

LDRSTR 

LINKLS 

LINKLSW 

LOGMSGl 
LPDA*01 
LPDA*02 
LRAD«01 
LR 10*01 
LTDA*01 
LTDA*02 
LUMAX 



LV30*01 



Address of 1st VME410 board 
Address of 2nd VME410 board 
Address of 1st VME420 board 
Address of 2nd VME420 board 
Address of 1st VME435 board 
Address of 2nd VME43S board 
Address of 1st VME600 board 
Address of 2nd VME&OO board 
Address of 1st VME605 board 
Address of 1st VME&IO board 
Address of 2nd VME&IO board 
Address of 1st VME615 board 
Address of 1st VME625 board 
Flag to include LDR module 
Address of LDR 
Link listing uork file 

Link listing file suitch 

= LINKLS is a file 

1 = LINKLS is a device 

Logon message part 1 

Local printer device address #1 

Local printer device address #2 

Address of 1st RAD board 

Address of 1st RIO board 

Local terminal device address #1 

Local terminal device address #2 

Logical unit number maximum. 

LUMAX is a temporary symbol used to set the value of MAXLUi 

uhich is the maximum logical unit number that can be 

assigned for each task in the system. 

Restrictions are: 8 <= LUMAX <= 31 

Address of 1st VM30 board 
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LV30S02 

LV30*03 

LV30*04 

LMIN»01 

LUIN«02 

M3 150*1 

M3151tl 

M3 152*1 

M3 153*1 

M3154*l 

M3 155*1 

M3 156*1 

M3 157*1 

M315DRV 

M320*DD 

M320*HD 

M320«LT5 

M320SLT8 

M320*LTH 

M320*SD 

M320*ST5 

M320*BTB 

M320*STH 

M3200*l 

M3201*l 

M3202*l 

M3203*l 

M3204*l 



Address of 2nd VM30 board 

Address of 3rd VM30 board 

Address of 4th Vti30 board 

Address of 1st RUIN board 

Address of 2nd RUIN board 

Type of disk on drive of 1st VME315 board 

Type of disk on drive 1 of 1st VME315 board 

Type of disk on drive 2 of 1st VME315 board 

Type of disk on drive 3 of 1st VME315 board 

Type of disk on drive 4 of 1st VME315 board 

Type of disk on drive 5 of 1st VME315 board 

Type of disk on drive 6 of 1st VME315 board 

Type of disk on drive 7 of 1st VME315 board 

Address of the VME315 driver 

Post-data gap double-density floppy format 

Post-data gap hard disk format 

Head load time 5-1/4" floppy drive in milliseconds 

Head load time 8" floppy drive in milliseconds 

Head load time hard disk drive in milliseconds 

Post-data gap single-density floppy format 

Head settling time S-1/4" floppy drive in milliseconds 

Head settling time 8" floppy drive in milliseconds 

Head settling time hard disk drive in milliseconds 

Type of disk on drive of 1st VI1E320 board 

Type of disk on drive 1 of 1st VME320 board 

Type of disk on drive 2 of 1st VME320 board 

Type of disk on drive 3 of 1st VME320 board 

Type of disk on drive 4 of 1st VME320 board 
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M320DRV 
M420DRV 
M435DRV 
M600DRV 
I1605DRV 
M610DRV 
M615DRV 
M625DRV 
MAXLU 



MCP»ATM 
MCP*AW 

MCPtDEN 

MCP*ERT 
MCP*PM 

MCP*RDT 

MCP4RDT0 

MCP*RTO 

MCP*RWTO 
MCP*SPTO 



Address of the VME320 driver 

Address of the VliE420 driver 

Address of the VME435 driver 

Address of the VME600 driver 

Address of the VME605 driver 

Address of the VME610/VME620 driver 

Address of the VliE615 driver 

Address of the V/ME625 driver 

MAXLU is kept to the minimuin value to alloui our standard 

sysgens to uiork in 384K. If you uiant morei change the "-t'3'' 

to add uihatever additional amount you need> or assign it to 

a specific value. (The "+3" luas arbitrarily chosen. > 

MAXLU and NOTASK determine the amount of memory required for 

the logical unit table (LUT). The algorithm for determining 

the LUT size is as follouis: 

LUT = 16+N0TASKS+8*N0TASKS»(MAXLU+1) 

There must be one LU for each disk volume (FMS assigns a 

different logical unit for each disk). This means that 

MAXLU must be greater that or equal to TOTDSK. 

Bit 1 is recognized for a configure command 

Bit O = Reserved 

Bit 1=1 means user requests a density for urite 

Bit 1 >: O means user does not request a density 

Density selected for write from loadpoint 

- 1600 bpi (PE density) 

1 - 800 bpi (NRZI density) 

Number of times to erase before error message 

DEN. RDT/ WRT. ERT fields are recognized for a configure 

command. 

ROTO. RMTO fields are recognized for a configure command. 

SPTO. SRTO fields are recognized for a configure command. 

Number of read tries before error message 

Read timeout 

Read Timeout (6 minutes to read 4K bytes, to search for 
a file mark, to read a blank tape to the end of tape, 
to reuiind) 

Reuind timeout 

Space forward or reverse timeout 
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MCP*SRTO 

MCP*WRT 

MCP»WTO 

MEMBEG 

MEMENDl 

MEMEND2 

MEMEND3 

MFPDRV 

MMU 

MPCCDRV 

MPSCDRV 

MPSCSPR 

MPSCSUP 

MTAOLVL 

MTAILVL 

N435»l 

N435*2 

NF315»1 

NF315»2 

NF320*1 

NF4205*1 

NF4208S1 

NFRWIN«1 

NFRUIN«2 

NH315*1 

NH315»2 

NH320*1 

NH4205*! 

NH4208«1 



Search foruard or reverse for filemark timeout 

Number of urite tries before erasing 

Write Timeout (5 seconds to uirite 4K bytes) 

Beginning of available rnemory 

Ending address for on-board memory; must be < this 

Starting address for off-board memory; must be >= this 

Ceiling address for off-board memoryi must be <I this 

Address of MFP driver 

Address of MMU 

Address of MPCC driver 

Address of MPSC driver 

Address of MPSCSPR driver 

Address of MPSCSUP driver 

Interrupt level 

Interrupt level 

Number of tape drives on 1st VME435 board 

Number of tape drives on 2nd VME435 board 

Number of floppy disks on 1st VME315 board 

Number of floppy disks on 2nd VME315 board 

Number of floppy disks on 1st VME320 board 

Number of S-1/4" floppy disks on SASI 5" board 

Number of 8" floppy disks on SASI 8" board 

Number of floppy disks on 1st RUIN board 

Number of floppy disks on 2nd RUIN board 

Number of hard disks on 1st VME319 board 

Number of hard disks on 2nd VME315 board 

Number of hard disks on 1st VnE320 board 

Number of hard disks on SASI 5" board 

Number of hard disks on SASI 8" board 
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NHRUINti 

NHRUIN«2 

NFV20*1 

NFV20*2 

NFV21»1 

NFV21*2 

NFV22»1 

NHV2I*1 

NHV2i*2 

NHV22*1 

NODEFVOL 

NQDIFFIL 



NOFILES 

NOLOGON 

NOLOGONS 

NOLPRT 

NQLTERM 

NORUIN 

NOTASKS 



NOTNT 
N0VM20 
N0VM2i 
N0VM22 



Number of hard disks on 1st RUIN board 

Number of hard disks on 2nd RUIN board 

Number of floppy disks on 1st VM20 board 

Number of floppy disks on 2nd VM20 board 

Number of floppy disks on 1st VM21 board 

Number of floppy disks on 2nd VM21 board 

Number of floppy disks on 1st Vli22 board 

Number of hard disks on 1st VM21 board 

Number of hard disks on 2nd Vli21 board 

Number of hard disks on 1st VH22 board 

The maximum number of default volumes that can be defined. 
Cannot be greater that NOTASKS+3. 

The maximum number of different files that can be opened at 
one time. Cannot be greater than NOFILES. For every three 
different files/ approximately IK of memory is required. 
A ratio of 5 files for each terminal accomodates most 
requests. 

The maximum number of files that can be opened in the system 
at one time. Limit of 200. 

Maximum number of invalid logon attempts before being 
rejected. 

Number of terminals allouied to logon in the system. 

Number of local printers 

Number of local terminals 

Number of RUIN board in the system 

The maximum number of tasks in the system at one time. 
Minimum of 1. VERSAdos contains a maximum of 6 resident 
tasks. Alloiding for thati plus three for each terminal 
(liill accomodate most requests. 

Number of Transparent Netuiork Terminals 

Number of VM20 boards in the system 

Number of VM21 boards in the system 

Number of VM22 boards in the system 
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N0VM30 

NP050*1 

NPV30*1 

NPV30*2 

NPV3043 

NPV30*4 

NRAD 

NRIO 

NRIOINT 

NT050*1 

NTV30«1 

NTV30S2 

NTV30*3 

NTV30*4 

NU400*1 

NU400*2 

NU410*1 

NU410*2 

NU605 

NU615 

NU625 

NURAD 

NVME050 

NVME300 

NVME315 

NVME31& 

NVME320 

NVME400 

NVME410 



Number of VM30 boards in the system 

Number of printers on 1st VME050 board 

Number of printers on 1st VM30 board 

Number of printers on 2nd VM30 board 

Number of printers on 3rd VM30 board 

Number of printers on 4th VM30 board 

Number of RAD boards in the system 

Number of RIO boards in the system 

Number of interrupt levels per I/O module 

Number of terminals on 1st VME050 board 

Number of terminals on 1st VM30 board 

Number of terminals on 2nd VM30 board 

Number of terminals on 3rd VM30 board 

Number of terminals on 4th VM30 board 

Number of users/printers on the 1st VME400 board 

Number of users/printers on the 2nd VME400 board 

Number of users/printers on the 1st VME410 board 

Number of users/printers on the 2nd VME410 board 

Number of users (total) for the VME605 boards 

Number of users <total) for the VME615 boards 

Number of users (total) for the VME625 boards 

Number of users on RAD boards 

Number of VME050 boards in the system 

Number of VME300 boards in the system 

Number of VME315 boards in the system 

Number of VME316 boards in the system 

Number of VME320 boards in the system 

Number of VME400 boards in the system 

Number of VME410 boards in the system 
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NVME4205 

NVME4208 

NVME435 

NVME600 

NVME605 

NVME610 

NVME615 

NVME620 

NVME625 

OFFBD*HI 

OFFBD*LO 

ONBO»HI 

ONBD»LO 

P050DRV 

P115DRV 

PAGES I ZE 

PANEL 

PAT 

PC DRV 
PCP*AFF 

PCP*ELC 
PCP*LNFD 

PCP»LRL 
PCPSREC 
PCP*RSZ 
PCP*TLRL 



Number of VME420 boards 
Number of VME420 boards 
Number of VME435 boards 
Number of VME600 boards 
Number of VME605 boards 
Number of VME610 boards 
Number of VME615 boards 
Number of VME620 boards 



in the system connected to a SASI 5" 
n the system connected to a SASI 8" 
n the system 
n the system 
n the system 
n the system 
n the system 
n the system 



Number of VME625 boards in the system 

High value for off-board RAM (as seen by driver) 

Loui value for off-board RAM (as seen by driver) 

High value for on-board RAM (as seen by driver) 

Loui value for on-board RAM (as seen by driver) 

Address of VME050 printer driver 

Address of VME115 printer driver 

Size in bytes of a page of memory 

Address of front panel 

The number of pages in the periodic activation table. 
Each page can accomodate approximately 8 entries. 

Number of Process Control Drivers 

Auto form feed 

= do not suppress auto form feed on assign 

1 = suppress auto form feed on assign 

End of line character 

Auto line feed 

= printer does not support auto line feed 

1 = printer does support auto line feed 

Logical line length <= uidth of printer 

Width of printer (characters/physical print line) 

Depth of printer (lines/page) 

Wrap-around /truncate 
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PCP*WTO 

PIADRV 

PTMVECT 

PVOIDRV 

RADDRV 

RIODRV 

RAM*SQ 

REVNUMBR 
ROMEADDR 

ROMSADDR 

RUIN0«1 

RUIN0«2 

RUIN1$1 

RMIN1«2 

RMIN2«1 

RWIN2«2 

RMIN3«1 

RMIN3«2 

RWINDRV 

SECURITY 

SERFLAG 

SERPTS 

SETl 



= wrap-around print i* logical line length exceeded 

1 = truncate print at logical line length 

Number of milliseconds to alloiu before timing out a write 

Address of the PIA driver 

Programmable timer vector number 

Address of VMOi printer driver 

Address of the RAD driver 

Address of the RIO driver 

Difference between on-board RAM address as seen by driver 
and device. 

Logon message part 2 

ROM end address; defined by user for a ROMable system. 
Set to *Q if not a ROMable system. 

ROM start address; 

Type of disk on drive of 1st RWIN board 

Type of disk on drive of 2nd RMIN board 

Type of disk on drive of 1st RMIN board 

Type of disk on drive of 2nd RWIN board 

Type of disk on drive of 1st RMIN board 

Type of disk on drive of 2nd RMIN board 

Type of disk on drive of 1st RMIN board 

Type of disk on drive O of 2nd RMIN board 

Address of RMIN driver 

Switch to indicate if security package is supported. 

Value of zero excludes packagCi nonzero includes it. This 

package requires approximately IK of memory. 

Serial port interrupt vector 

A user definable parameter that can take on any one of the 
following values: 

"SYSTEM", "USER", or "DONT-CARE" 
If SETl is set to "SYSTEM" then the cache bank should be set 
up as a supervisory cache. In this mode, RMS and the 
drivers will use the cache and RMS will not flush the cache 
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SIOBASE 
SIODRV 
SIX 
SPCCMD 



on task suiitches. If SETl is set to any other value, then 
RMS mill flush the cache on all task suiitches that force a 
change in address space number. 

A user definable parameter that can take on any one of the 
follouiing values: 

"SYSTEM", "USER", or "DONT-CARE" 
If SET2 is set to "SYSTEM" then the cache bank should be set 
up as a supervisory cache. In this mode, RMS and the 
drivers mill use the cache and RMS uiill not flush the cache 
on task suiitches. If SET2 is set to any other value, then 
RMS will flush the cache on all task switches that force a 
change in address space number. 

Base address of Short I/O address space 

Address of SIO driver 

Starting disk number in ASCII for drive 6 

Suiitch to indicate if the following user session management 
commands are supported: HELP, CLOSE, ASSIGN, NEUS. 
Value of zero excludes commands. This package requires 
approximately 1/2K of memory. 



STACK 
STARTRMS 
SWABRT 
SYSFAIL 



Address of stack 



Softbiare abort vector number 

Determines whether or not the operating system will be 
interrupted when SYSFAIL is asserted on the bus. Some 
intelligent boards will assert SYSFAIL when they experience 
a failure of some kind. If you have such boards in the 
system, AND THE DRIVERS FOR THESE BOARDS HAVE SYSFAIL 
HANDLERS, then you will probably want SYSFAIL interrupts 
enabled. If the appropriate SYSFAIL handlers are not 
written, then taking a SYSFAIL interrupt will hang up the 
system, so you would want SYSFAIL interrupts disabled. 

= disable SYSFAIL interrupts 

1 = enable SYSFAIL interrupts 



TCP*BITS 



7/8 bits/char 

= transmit/receive 8 bits/character 

1 = transmit/receive 7 bits/character 



TCP*BRC 



Character to be interpreted like 
O = none 



break when received 



TCP*BRT 



Baud rate code 

The following code may be used to set the desired baud rate. 



Code 


Rate 


Code 


Rate 


Code 


Rate 


Code Rate 


»00 


50 


*05 


300 


♦09 


2000 


»0E 9600 


»01 


75 


»0& 


600 


»0A 


2100 


*0F 19200 


«02 


110 


»07 


1200 


SOB 


4800 


*10-*1FF 


*03 


134. 5 


»08 


ISOO 


*0C 


7200 


Reserved 
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TCP*DOP 



Character which causes line to be deleted when received 
O = none 

Character uihich causes output to be discarded when received 
O = none 



TCP*ECHO 



TCP*EOL 
TCP*HCPY 



TCP*MODM 



TCP*NLS 
TCPtOFFH 



TCP*PNUL 



Echo characters 

= driver should echo characters 

1 = driver should not echo characters 

End of line string 

Hardcopy device 

= terminal is not a hard copg device it is a CRT 

1 = terminal is a hard copy device not a CRT 

Modem connect 

= the port is not connected to a modem 

1 = the port is connected to a modem 

Number of ASCII null characters to send after each CR or LF 

Modem Offhook 

= the port (if connected to modem) is not offhook 

1 = the port (if connected to modem) is offhook 

Null characters 

= Null characters are not considered data for image read 

1 = Null characters should be considered data for image 

reads 



B 



TCP*PRTY 

TCP»REC 
TCP*RLN 

TCP»RSZ 
TCP*RTO 
TCP»RTV 
TCP*STPB 

TCP*TAHD 

TCPtTFUL 



odd/even parity 

= parity (if used) should be odd 

1 = parity (if used) should be even 

Midth of terminal (characters/line) 

Character uihich causes line to be reprinted when received 
= none 

Depth of terminal (lines/page) 

Number of milliseconds to allow before timing out a read 

Read terminators 

1/2 stop bits 

= follow each character with 1 stop bit 

1 = follow each character with 2 stop bits 

Type ahead 

= the type ahead feature is used 

1 = the type ahead feature is not used 

Terminate the read of buffer full 

O = filling the buffer on a read will not term, the read 
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TCP«TRC 
TCP»TTP 
TCP*USEP 

TCPtWTO 
TCPtXCTL 

TCP»XOF 

TCP*XON 

TERMDRV 

TERMLIB 

TERMOCNT 

TIMER 

TIMINTV 

TIMSLIC 

TOTDSK 

TOTTERM 

TRACE 

TRCFLAG 



1 = filling the buffer on a read should terminate the read 

Terminator class 
*0X = none 

Terminal type 

= EXORterm 155 

Parity check 

= do not use parity 

1 = parity should be checked and generated 

Number of milliseconds to allow before timing out a uirite 

XON/XOFF control 

= use CTS to control transmission 

1 = use XON/XOFF characters to control transmission 

XOFF character! when received, suspends transmission 
= none 

XON character; when received, cancels a prior XOFF character 
= any character 

Address of TERMDRV 

Address of TERMLIB 

Number of terminal output timeouts before logoff 

Address of timer 

The number of milliseconds between timer interrupts 

The number of timer interrupts per time slice 

Total number of disks 

Total number of terminals 

Number of pages in trace table. TRACE must be nonzero 
if TRCFLAG is nonzero. Each page can accomodate 
approximately 10 entries. 

Trace flag 

= don't trace 

The setting of bits in the TRCFLAG parameter will control 
which events cause an entry to be built in the trace table 

Bit * in TRCFLAG Event 

15 TRAP #1 

14 I/O interrupt not claimed by 

user task 

13 Timer interrupt 

12 User trap (2-15) 

11 Exception 

10 Dispatch 

9 I/O interrupt claimed by user 
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task 

Return from LOADMMU 
Simulated interrupt 
SYSFAIL interrupt 



TWO 
U0R 

UST 

VM200*1 
VM200»2 
VM201»1 
VM201*2 
VM202*1 
VM202*2 
VM203»1 
VM203*2 
VM210*1 
VM210*2 
VM211*! 
VM211*2 
VM212*1 
VM212S2 
VM213*1 
VM21342 
VM214*1 
VM214«2 
VM215*1 
VM215*2 
VM216»1 



Starting disk number in ASCII for drive 2 

Number of pages in user defined directive table. Minimum 
of 0. Maximum of 10. Each page can accomodate 
approximately 25 entries. 

The number of pages in the user semaphore table. 
Minimum of 1. maximum of 10. Each page can accomodate 
approximately 25 entries. 

Type of disk on drive on 1st VM20 board 

Type of disk on drive on 2nd VM20 board 

Type of disk on drive 1 on 1st VM20 board 

Type of disk on drive 1 on 2nd VM20 board 

Type of disk on drive 2 on 1st VM20 board 

Type of disk on drive 2 on 2nd VM20 board 

Type of disk on drive 3 on 1st VM20 board 

Type of disk on drive 3 on 2nd VM20 board 

Type of disk on drive on 1st VM21 board 

Type of disk on drive on 1st VM21 board 

Type of disk on drive 1 on 1st VM21 board 

Type of disk on drive 1 on 1st VM21 board 

Type of disk on drive 2 on 1st VM21 board 

Type of disk on drive 2 on 1st VM21 board 

Type of disk on drive 3 on 1st VM21 board 

Type of disk on drive 3 on 1st VM21 board 

Type of disk on drive 4 on 1st VM21 board 

Type of disk on drive 4 on 1st VM21 board 

Type of disk on drive 5 on 1st VM21 board 

Type of disk on drive 5 on 1st VM21 board 

Type of disk on drive 6 on 1st VM21 board 
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VM2i6*2 
VM217»1 
VM217*2 
VM220»1 
VM221»1 
VM222»1 
VM223*1 
VM224»1 
VM225»1 
VM226*1 
VM227*1 
VM22S*1 
VM229»1 
VM22A*1 
VM22B*1 
VM22DRV 
WHERLOAD 

WQRKLB 
ZERO 



Type of disk on drive b on 1st VM21 board 

Type of disk on drive 7 on 1st VM21 board 

Type of disk on drive 7 on 1st VM21 board 

Type of disk on drive on 1st VM22 board 

Type of disk on drive 1 on 1st VM22 board 

Type of disk on drive 2 on 1st VM22 board 

Type of disk on drive 3 on 1st VM22 board 

Type of disk on drive 4 on 1st VM22 board 

Type of disk on drive 5 on 1st VM22 board 

Type of disk on drive 6 on 1st VM22 board 

Type of disk on drive 7 on 1st VM22 board 

Type of disk on drive 8 on 1st VM22 board 

Type of disk on drive 9 on 1st VM22 board 

Type of disk on drive A on 1st VM22 board 

Type of disk on drive B on 1st VM22 board 

Address of the VM22 driver 

Memory address where boot file mill be loaded. 

Non-zero for VMOl only. If noniero. VERBAdos mill be moved 

at initialization time. 

Overall listing file/device 

Starting disk number in ASCII for drive 
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APPLICATION INCLUDE FILE EXAMPLES 



ASSEMBLER APPLICATION EXAMPLE 

The DUMP utility is modified for ROM application to allow the user the 

capability to access another terminal, the printer, and the disk as device 

assignments. The application INCLUDE file is .&.DUMP.CI and its associated 
file is .&.DUMP.LG. 

.&.DUMP.CI 



***************** 

* DUMP. CI * 
************************************************************************* 

* DUMP utility modified to demonstrate ROMability 
************************************************************************* 



B 



TASK 


&.DUMP.LO,.DMP 


ATTRIB 


= 'USER' 


STATE 


= 'READ' 


SESSION 


= 7 


PRIORITY 


= $42 


SUBS 


&.DUMP.LG 


LINK 


&.DUMP.LG 


IFEQ 


\LINKLSW 


=COPY 


\LINKLS,\WORKLS;A 


ENDC 




END 


DUMP 



■&.DUMP.LG 



=LINK ,&.DUMP.LO,\LINKLS;HAMIX 
SEG SEG0:0,14 \PC 
INPUT &.DUMP.RO 
LIB &.UTILIB.RO 
END 
=END 
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PASCAL APPLICATION EXAMPLE 



This Pascal task, which executes an infinite loop, is a simple task that 
writes to the printer and the terminal using the floating point capability. 
The application INCLUDE file is .&.PTASKFP.CI and its associated files are 
RROM.RLIBFP.LG and RROM.TASKFP.LG. If the user wants to use the non-floating 
point library, replace RROM.RLIBFP.LG with RROM.RLIBNFP.LG and RROM.TASKFP.LG 
with RROM.TASKNFP.LG. 



.&.PTASKFP.CI 



a 



f^5Q ***************************************************************** 

MSG * * 

MSG * LINK THE GLOBALLY SHAREABLE PASCAL RUN-TIME ROUTINES FOR * 

MSG * ROM USAGE * 

MSG * * 

MSG ***************************************************************** 

GSPLSTR = * 

SUBS RROM.RLIBFP.LG 

LINK RROM.RLIBFP.LG 

IFEQ \LINKLSW 

=COPY \LINKLS,\WORKLS;A 
ENDC 
PROCESS RROM.RLIBFP.LO 



MSG 
MSG 
MSG 
MSG 
MSG 
MSG 
MSG 
MSG 
MSG 



*************************************************************** 

* * 

* LINK THE GLOBALLY SHAREABLE PASCAL RUN-TIME ROUTINES TO * 

* THE USER TASK. THIS IS NECESSARY TO SATISFY EXTERNAL * 

* REFERENCES BUT SEGO WILL BE EXCLUDED AS SEGO * 

* IS DEFINED ABOVE IN THE ROM LIBRARY AND SEG2 WILL * 

* BE OBTAINED DYNAMICALLY BY THE INITIALIZER * 

* * 
*************************************************************** 



TASK &.PTASK.LO 

ATTRIB = 'USER' 

STATE = 'READ' 

SESSION = $100 

PRIORITY = $90 

EXCLUDE SEGO 

EXCLUDE SEG2 

SUBS RROM.TASKFP.LG 

LINK RROM.TASKFP.LG 

IFEQ \LINKLSW 

=COPY \LINKLS,\WORKLS;A 
ENDC 

END PTASK 
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RROM.RLIBFP.LG 



=/* 

=/* 

=/* RROM.RLIBFP.LG chainfile to link globally shareable Pascal 

=/* run-time routines. These run-time routines 

=/* INCLUDE floating point. 

=/* 

=/* 

=LINK ,RROM.RLIBFP.LO,\LINKLS;HAMIXSZ=100 

SESG SEG0(RG):8 \GSPLSTR 

INPUT RROM.RLIBFP.ro 

END 



RROM.TASKFP.LG 



=/* 

=/* RROM.TASKFP.LG chainfile to link globally shareable Pascal 

=/* run-time routines to a user task. The run- 

=/* time routines INCLUDE floating point. 

=/* 

=/* The following SYSGEN link file can be used by the user by 

=/* changing only the name of the applications task '????' where 

=/* referenced. NOTE that the library modules are 'INCLUDEd', 

=/* not 'LIBed'. This is necessary to properly satisfy external 

=/* references with a shared library. 

=/* 

=/* 

=LINK ,&.PTASK.LO,\I-INKLS;HAMIXSZ=100 

SEG PROG (R):9 \PC 

SEG SEG0{RG):8 \GSPLSTR 

SEG SEG2(R):15 

IN &.PTASK.RO 

IN rrom.init.ro 
IN rrom.assignlu.ro 
IN rrom.rlibfp.ro 

END 
=END 
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APPENDIX F 
SYSTEM SYSGEN LISTING EXTRACT 



The program counter with the startup address specified for the user SYSGEN 
system listing should be set. In this example, the program counter is set to 
$312600. 



FILENAME 


TASK 


PROC 
RMS 


SEG 
RMSO 


ADDRESS 


RMS.LO 


$300000 








RMS2 


$300100 


DRVLIB.LO 




DRVL 


DRVL 


$304E00 


TERMLIB.LO 




TERM 


TERM 


$305000 


ACIADRV.LO 




AC I A 


AC I A 


$306300 


PIADRV.LO 




PI AD 


PIAD 


$306500 


FHS.LO 


.FHS 




.FHS 


$306C00 


lOS.LO 


.lOS 




.lOS 


$308000 


RLIBFP.LO 




RLIB 


SEGO 


$309A00 


PTASK.LO 


PTAS 




PROG 


$311200 


lOI.LO 


.101 




lOSF 
.101 


$311900 
$312100 


SYSINIT.LO 




SYSI 


.INT 


$312600 



- START-UP ADDRESS = $312600 

TOTAL NUMBER OF USER DEFINED SYMBOLS = 204 

ERRORS ENCOUNTERED 
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INDEX 



ABORT 

account number 

ampersand {&) 

angle brackets (< >) 

ARG 

arguments 

ASM 

ASQ 

assembler 

asterisk {*) 

Asynchronous Service Queue (ASQ) 

ATTRIB 

attributes 

backslash (\) 

baud rate 

boot 

BREAK 

break service 

catalog 

catalog names 

CCB 

CDB 

CHAIN 

chain filenames 

Channel Data Block (CDB) 

Channel Control Block (CCB) 

CNFGDRVR.CI 

CNFGTASK.CI 

command file 

command filenames 

comment 

conditional processing 

CONFIG utility 

COPY utility 

COPYSGEN.CF 

CPU 

CRC 

cross reference file 

CRTDCB 

Cyclic Reduncancy Check (CRC) 

$DATE 

DCB 

DCQ 

Device Connection Queue (DCQ) 

Device Control Block (DCB) 

DIPDCB 



17, 23 

10, 49 

1, 19, 24, 29, 31 
4 

13, 18, 19, 25 

I, 11-13, 17, 56, 57, 59, 60 

14, 17, 22, 23, 30 

See Asynchronous Service Queue 

17, 19, 22, 23, 37, 101 

17, 19 

46 

21 

3, 14, 21, 47, 49, 54-57, 59, 60, 63-68 

20, 29 
56, 64 

1, 10-14, 28, 29, 45 
27, 56, 64 

63, 65, 67 

2, 9-13, 23, 35, 39, 81 
2 

See Channel Control Block 

See Channel Data Block 

22 

2 

1, 45, 49, 54, 61, 69 

45 49 61 

1,'2, io, II, 15, 38, 49, 71 

36 

1-3, 9, 13-15, 17, 18, 22, 26, 28-31, 

71 

2 

17, 19, 20, 23, 24, 26-30 

17, 24 

49 

12, 14, 17, 22, 99, 100 

I, 2, 9, 35, 36 

10 

See Cyclic Redundancy Check 

11, 12, 16, 31 
54, 56, 63 

54 

22 

See Device Control Block 

See Device Connection Queue 

3, 63, 67 

1, 47-49, 54-57, 59, 60, 63, 65, 67 
54, 56, 57, 59, 60, 63, 65, 67 
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disk controllers 

dollar sign {$) 

driver file(s) 

drivers 

DSKDCB 

DUMP utility 

ECC 

editor 

EET 

END 

end-of-line 

ENDC 

equal sign (=) 

equate files 

Error Correction Code 

event cl aimer 

EXCLUDE 

executive 

Exit/Entry Task (EET) 

EXORmacs 

EXORterm 

FAT 

FCB 

FDC 

FHS 

File Assignment Table (FAT) 

File Control Block (FCB) 

File Handling Services (FHS) 

File Management System (FMS) 

filemark 

floating point 

Floppy Disk Controller (FDC) 

floppy disk drives 

FMS 

Global Segment Table (GST) 

GPIB 

GST 

hard disk drives 
hexadecimal , hex 

IFDRVR.CI 

IFxx 

INCLUDE 

INCLUDE file(s) 

initializer 

Input/Output Control Block (lOCB) 

Input/Output Services (lOS) 

Intelligent Peripheral Controller (IPC) 



19, 


20, 


24, 29, 31 




10, 


11, 


15 




1, 


2, 9 


, 10, 11, 35 


38, 49, 55 


54, 


57, 


67 




101 








See 


Error Correctior 


1 Code 


9, 1 


31 






See 


Exi 


t/Entry Task 




17, 


18, 


23, 28, 29, 


31 


56, 


59, 


64, 66 




17, 


24, 


25 




17, 


19, 


31 




2, 


3, 54 




58, 


68 






63, 


65, 


67 




17, 


24 






28 








36, 


39 






1, 


2, 50, 64 




55, 


57, 


64 




See 


Fil 


e Assignment 


Table 


See 


Fil 


e Control Bl( 


jck 


See 


Floppy Disk Controller 


See 


Fil 


e Handling Services 


46 








46- 


48 






37, 


48 






36, 


46 






54, 


60 






39, 


41- 


44, 102, 103 




51 








51, 


52 






See 


Fil 


e Management System 


3 








55 








See 


Glo 


bal Segment 


Fable 


51, 


52 






19, 


20, 


25, 28 




1, 


2, 


11, 15, 71 




17, 


24, 


25 




1, 


17, 


25, 42, 43, 


103 


1-3 


, 25 


, 35, 37, 44 


, 101 


14, 


39 






63, 


65, 


67 




37, 


39, 


48 





51, 55 
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invocation 




3, 9-16, 35, 36, 38 


lOCB 




See Input/Output Control Block 


I/O Channel 




50 


lOC.RO 




15, 45 


lOI 




38, 45, 46 


I/O initializer 




38, 45 


lOS 




See Input/Output Services 


lOSG 




45, 46 


IPC 




See Intelligent Peripheral Controller 


jumper(s) 




50, 52 


kernel 




1, 35, 45 


LDR 




See Loader 


LIB 




See Loader Information Block 


LIB utility 




42, 43, 103 


library 




39, 41-43, 102, 103 


LINK 




14, 17, 22, 26, 42, 43 


linkage editor, li 


[iker 


17, 26, 31, 45 


listing file(s) 




1, 2, 10-12, 16, 23, 31 


Loader 




36 


Loader Information 


Block (LIB) 


14, 24, 28, 29, 31 


load module(s) 




3, 9, 28-31, 45 


location counter 




18, 19, 26-29, 31 


Logical Unit (LU 




3, 39, 46-48 


Logical Unit Table 


(LUT) 


46, 47 


LU 




See Logical Unit 


LUT 




See Logical Unit Table 


macro (s) 




2, 9, 45, 54, 56, 57, 59-61, 63, 69 


magnetic tape 




49, 52-55, 60 


map 




3, 12, 45 


match pattern 




15 


MCCM 




See Multi-Channel Communications Module 


MEMEND 




37 


Memory Management 


Unit(s) (MMU) 


1, 14, 28, 31 


memory requirement 




1 


message(s) 




11, 13, 15, 16, 18, 27, 60 


minus sign (-) 




19 


MMU 




See Memory Management Unit 


modem 




57 


module stream 




3 


MSG 




18, 27 


MTADCB 




54, 60 


MVMElOl 




2 


MVMEllO 




2, 35-37, 53 


MVME1I7 




2 


MVME120/121 




2 


MVME122/123 




2 


MVME130/131 




2 


MVME300 




55 


MVME315 




51 


MVME400 
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MVME410 
MVME420 

NOARG 

NOLIST.SYSGEN.CF 

notation 

page size 
parameter{s) 

Pascal compiler 

Pascal initializer 

Pascal run-time routines 

PAUSE 

PC 

period (.) 

plus sign (+) 

polling 

printer(s) 

PRIORITY 

PROCESS 

process stream 

program counter 

PROMs 

PRTDCB 

pseudo registers 

$RA 

RAM 

$RD 

Read Only Memory (ROM) 

related documentation 

Relinquish 

relocatable module(s) 

restart 

RMS68K 

RMSGEN.CF 

ROM 

ROM library 

run -time library 

RWINl 

SEGMENT 

segment stream 

SESSION 

SGSYMBL.LO 

spooler task 

square brackets {[ ]) 

stack 

STATE 

STD.SYSGEN.CF 

stepping rate code 

SUBS 



50 








52 








11, 12 








1, 3, 9, 10, 12 








4 








1 








1, 2, 9, 10, 15 


-23, 25, 


26, 29-31, 


36, 


38, 45, 49, 54- 


59, 81 






39-44 








37, 39 








35, 39, 102, 103 






14, 18, 27 








18, 27, 28 








19, 24, 29, 31 








19 








61, 62, 69 








49, 50, 54, 55, 


59, 65, 


101 




21, 37, 45 








18, 24, 28, 29, 


31 






18, 28 








37, 38, 105 








39 








54, 59, 65 








22 








22 








1, 14, 35, 45 








22 








3, 13, 14, 35-44, 100, 


101 




4 








37, 39 








3, 23, 26 








14, 15, 28 








1, 35, 36, 45, ' 


(8 






36 








See Read Only Memory 






39, 41-44 








35, 39 








52 








18, 28, 29, 31 








18, 29 








21 








12, 16, 31, 32 








50 








4 








39, 46 








21, 45 








1, 2, 9-11, 31, 


38, 71 






58 








14, 17, 21, 22, 


26, 29, 


30 
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supervisor mode 




3, 28 


SVT 




See System Value Table 


symbol table 




15, 16 


syntactic variables 




4 


SYSGEN.CF 




1, 9-13, 31, 36, 71 


SYSGEN execution 




11, 14, 18, 19 


SYSGEN.NW 




81 


SYSINIT 




45 


SYSTEM. CI 




1, 2, 10, 15, 35, 36, 50, 71 


System Value Table 


(SVT) 


46, 48 


TASK 




18, 21, 24, 28-31 


Task Control Block 


(TCB) 


3, 14, 19, 21, 22, 45 


Task Segment Table 


(TST) 


3, 14 


task stream 




18, 26, 30, 31 


TCB 




See Task Control Block 


$TCBLST 




22 


$TCBRDY 




22 


terminal (s) 




18, 39, 49, 50, 54-57, 63, 64, 101, 102 


$TIME 




22 


Trace Table (TT) 




3 


TRAP #2 




48, 55 


TRAP #3 




48 


traps 




48, 55 


TST 




See Task Segment Table 


TT 




See Trace Table 


UDC 




See Universal Disk Controller 


Universal Disk Controller (UDC) 


51 


USER 




21 


user number 




9, 11-14, 21, 35, 36, 38, 44, 47 


UTILIB.RO 




2, 9 


VALPAR.CI 




15 


VDT 




See Volume Descriptor Table (VDT) 


vector 




28, 61, 69 


VERSADOS.CD 




1, 2, 9-12, 15, 37 


VERSADOS.SY 




2, 9, 10, 12, 13, 36, 38, 49 


VERSAPT patch files 




1 


VMOl 




2, 45 


VM02 




2 


VM03 




2 


VM04 




1. 2 


VM22 




51 


VMC 68/2 




2, 50 


VME/10 




2, 3, 50, 55, 71 


VMEmodule 




1 


volume 




2, 9, 11, 12, 13, 30 


Volume Descriptor Table (VDT) 


46 


WHERLOAD 




45 


XOFF 




56, 64 


XON 




56, 64 
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